@vcp-dev/contracts 0.6.9 → 0.6.11

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

@@ -7,6 +7,8 @@ export declare const DESIGNER_COMPONENT_LIBRARY_ERROR_CODES: {
     readonly invalidResponse: "DESIGNER_COMPONENT_LIBRARY_INVALID_RESPONSE";
     readonly incompatibleResource: "DESIGNER_COMPONENT_RESOURCE_INCOMPATIBLE";
 };
+export declare const DesignerResourceVersionSchema: z.ZodNumber;
+export type DesignerResourceVersion = z.infer<typeof DesignerResourceVersionSchema>;
 export interface DesignerComponentCategoryNode {
     readonly id: string;
     readonly key: string;
@@ -23,7 +25,7 @@ export declare const DesignerComponentCatalogItemSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodNullable<z.ZodString>;
     thumbnail_url: z.ZodNullable<z.ZodString>;
-    resolved_version: z.ZodString;
+    resolved_version: z.ZodNumber;
     category_id: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>;
 export declare const DesignerComponentsDataSchema: z.ZodObject<{
@@ -33,14 +35,14 @@ export declare const DesignerComponentsDataSchema: z.ZodObject<{
         name: z.ZodString;
         description: z.ZodNullable<z.ZodString>;
         thumbnail_url: z.ZodNullable<z.ZodString>;
-        resolved_version: z.ZodString;
+        resolved_version: z.ZodNumber;
         category_id: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>>;
     next_cursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>;
 export declare const MockDesignerComponentInsertRequestSchema: z.ZodObject<{
     resource_id: z.ZodString;
-    resolved_version: z.ZodString;
+    resolved_version: z.ZodNumber;
     anchor_block_id: z.ZodString;
     placement: z.ZodEnum<{
         before: "before";
@@ -65,14 +67,14 @@ export type DesignerComponentsData = z.infer<typeof DesignerComponentsDataSchema
 export type MockDesignerComponentInsertRequest = z.infer<typeof MockDesignerComponentInsertRequestSchema>;
 export type MockDesignerComponentInsertData = z.infer<typeof MockDesignerComponentInsertDataSchema>;
 export type ListDesignerComponentsQuery = z.infer<typeof ListDesignerComponentsQuerySchema>;
-export declare const DesignerComponentExactVersionSchema: z.ZodString;
+export declare const DesignerComponentExactVersionSchema: z.ZodNumber;
 export declare const InstallDesignerComponentBodySchema: z.ZodObject<{
-    version: z.ZodString;
+    version: z.ZodNumber;
 }, z.core.$strict>;
 export declare const DesignerComponentInstallDataSchema: z.ZodObject<{
     resource_id: z.ZodString;
-    resolved_version: z.ZodString;
-    revision_id: z.ZodString;
+    resolved_version: z.ZodNumber;
+    revision_id: z.ZodOptional<z.ZodString>;
     digest_sha256: z.ZodString;
     materialization: z.ZodObject<{
         instanceBaseName: z.ZodString;

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

@@ -8,17 +8,17 @@ export declare const DESIGNER_PAGE_LIBRARY_ERROR_CODES: {
     readonly incompatibleResource: "DESIGNER_PAGE_RESOURCE_INCOMPATIBLE";
 };
 export declare const DesignerPageResourceTypeSchema: z.ZodEnum<{
-    page: "page";
     pages: "pages";
+    page: "page";
 }>;
 export type DesignerPageResourceType = z.infer<typeof DesignerPageResourceTypeSchema>;
 export declare const DesignerPageResourceSourceSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
-    resolved_version: z.ZodString;
+    resolved_version: z.ZodNumber;
     template_page_id: z.ZodString;
 }, z.core.$strict>;
 export type DesignerPageResourceSource = z.infer<typeof DesignerPageResourceSourceSchema>;
@@ -36,13 +36,13 @@ export declare const DesignerPageCategoriesDataSchema: z.ZodObject<{
 export declare const DesignerPageCatalogItemSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
     name: z.ZodString;
     description: z.ZodNullable<z.ZodString>;
     thumbnail_url: z.ZodNullable<z.ZodString>;
-    resolved_version: z.ZodString;
+    resolved_version: z.ZodNumber;
     category_id: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>;
 export declare const DesignerPagesDataSchema: z.ZodObject<{
@@ -50,13 +50,13 @@ export declare const DesignerPagesDataSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         resource_id: z.ZodString;
         resource_type: z.ZodEnum<{
-            page: "page";
             pages: "pages";
+            page: "page";
         }>;
         name: z.ZodString;
         description: z.ZodNullable<z.ZodString>;
         thumbnail_url: z.ZodNullable<z.ZodString>;
-        resolved_version: z.ZodString;
+        resolved_version: z.ZodNumber;
         category_id: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>>;
     next_cursor: z.ZodNullable<z.ZodString>;
@@ -74,7 +74,7 @@ export type DesignerPageCategoriesData = z.infer<typeof DesignerPageCategoriesDa
 export type DesignerPageCatalogItem = z.infer<typeof DesignerPageCatalogItemSchema>;
 export type DesignerPagesData = z.infer<typeof DesignerPagesDataSchema>;
 export type ListDesignerPagesQuery = z.infer<typeof ListDesignerPagesQuerySchema>;
-export declare const DesignerPageExactVersionSchema: z.ZodString;
+export declare const DesignerPageExactVersionSchema: z.ZodNumber;
 /**
  * Designer phase one intentionally supports one route segment only. The
  * designer owns the final route (including an optional random suffix); the
@@ -96,10 +96,10 @@ export declare const PageResourceDraftPageSchema: z.ZodObject<{
     source: z.ZodOptional<z.ZodObject<{
         resource_id: z.ZodString;
         resource_type: z.ZodEnum<{
-            page: "page";
             pages: "pages";
+            page: "page";
         }>;
-        resolved_version: z.ZodString;
+        resolved_version: z.ZodNumber;
         template_page_id: z.ZodString;
     }, z.core.$strict>>;
     blocks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -111,7 +111,7 @@ export declare const PageResourceDraftPageSchema: z.ZodObject<{
         kind: z.ZodLiteral<"component-resource">;
         instance_id: z.ZodString;
         resource_id: z.ZodString;
-        resolved_version: z.ZodString;
+        resolved_version: z.ZodNumber;
         label: z.ZodString;
     }, z.core.$strict>], "kind">>>;
     route: z.ZodObject<{
@@ -125,20 +125,20 @@ export type PageResourceDraftPage = z.infer<typeof PageResourceDraftPageSchema>;
 export declare const PageResourceDraftSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
-    resolved_version: z.ZodString;
+    resolved_version: z.ZodNumber;
     pages: z.ZodArray<z.ZodObject<{
         template_page_id: z.ZodString;
         title: z.ZodString;
         source: z.ZodOptional<z.ZodObject<{
             resource_id: z.ZodString;
             resource_type: z.ZodEnum<{
-                page: "page";
                 pages: "pages";
+                page: "page";
             }>;
-            resolved_version: z.ZodString;
+            resolved_version: z.ZodNumber;
             template_page_id: z.ZodString;
         }, z.core.$strict>>;
         blocks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -150,7 +150,7 @@ export declare const PageResourceDraftSchema: z.ZodObject<{
             kind: z.ZodLiteral<"component-resource">;
             instance_id: z.ZodString;
             resource_id: z.ZodString;
-            resolved_version: z.ZodString;
+            resolved_version: z.ZodNumber;
             label: z.ZodString;
         }, z.core.$strict>], "kind">>>;
         route: z.ZodObject<{
@@ -164,10 +164,10 @@ export declare const PageResourceDraftSchema: z.ZodObject<{
 export type PageResourceDraft = z.infer<typeof PageResourceDraftSchema>;
 export declare const InstallDesignerPageBodySchema: z.ZodObject<{
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
-    version: z.ZodString;
+    version: z.ZodNumber;
     pages: z.ZodArray<z.ZodObject<{
         template_page_id: z.ZodString;
         title: z.ZodString;
@@ -233,11 +233,11 @@ export type PageResourcePage = z.infer<typeof PageResourcePageSchema>;
 export declare const PageResourceArtifactSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
-    resolved_version: z.ZodString;
-    revision_id: z.ZodString;
+    resolved_version: z.ZodNumber;
+    revision_id: z.ZodOptional<z.ZodString>;
     digest_sha256: z.ZodString;
     components: z.ZodArray<z.ZodObject<{
         component_id: z.ZodString;
@@ -293,11 +293,11 @@ export type PageResourceArtifact = z.infer<typeof PageResourceArtifactSchema>;
 export declare const DesignerPageInstallDataSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
-    resolved_version: z.ZodString;
-    revision_id: z.ZodString;
+    resolved_version: z.ZodNumber;
+    revision_id: z.ZodOptional<z.ZodString>;
     digest_sha256: z.ZodString;
     components: z.ZodArray<z.ZodObject<{
         component_id: z.ZodString;
@@ -371,10 +371,10 @@ export type DesignerPageResourceTemplate = z.infer<typeof DesignerPageResourceTe
 export declare const DesignerPageResourcePreparationDataSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
-    resolved_version: z.ZodString;
+    resolved_version: z.ZodNumber;
     pages: z.ZodArray<z.ZodObject<{
         template_page_id: z.ZodString;
         title: z.ZodString;
@@ -389,30 +389,30 @@ export declare const DesignerPageResourcePreparationDataSchema: z.ZodObject<{
 export type DesignerPageResourcePreparationData = z.infer<typeof DesignerPageResourcePreparationDataSchema>;
 export declare const PrepareDesignerPageBodySchema: z.ZodObject<{
     resource_type: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
     }>;
-    version: z.ZodString;
+    version: z.ZodNumber;
 }, z.core.$strict>;
 export type PrepareDesignerPageBody = z.infer<typeof PrepareDesignerPageBodySchema>;
 export declare const ComposeDesignerPageResourceBodySchema: z.ZodObject<{
     draft: z.ZodObject<{
         resource_id: z.ZodString;
         resource_type: z.ZodEnum<{
-            page: "page";
             pages: "pages";
+            page: "page";
         }>;
-        resolved_version: z.ZodString;
+        resolved_version: z.ZodNumber;
         pages: z.ZodArray<z.ZodObject<{
             template_page_id: z.ZodString;
             title: z.ZodString;
             source: z.ZodOptional<z.ZodObject<{
                 resource_id: z.ZodString;
                 resource_type: z.ZodEnum<{
-                    page: "page";
                     pages: "pages";
+                    page: "page";
                 }>;
-                resolved_version: z.ZodString;
+                resolved_version: z.ZodNumber;
                 template_page_id: z.ZodString;
             }, z.core.$strict>>;
             blocks: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -424,7 +424,7 @@ export declare const ComposeDesignerPageResourceBodySchema: z.ZodObject<{
                 kind: z.ZodLiteral<"component-resource">;
                 instance_id: z.ZodString;
                 resource_id: z.ZodString;
-                resolved_version: z.ZodString;
+                resolved_version: z.ZodNumber;
                 label: z.ZodString;
             }, z.core.$strict>], "kind">>>;
             route: z.ZodObject<{
@@ -437,15 +437,11 @@ export declare const ComposeDesignerPageResourceBodySchema: z.ZodObject<{
     }, z.core.$strict>;
 }, z.core.$strict>;
 export type ComposeDesignerPageResourceBody = z.infer<typeof ComposeDesignerPageResourceBodySchema>;
-export declare const DesignerSitePageSchema: z.ZodObject<{
-    title: z.ZodString;
-    route_id: z.ZodString;
-}, z.core.$strict>;
-export type DesignerSitePage = z.infer<typeof DesignerSitePageSchema>;
 export declare const DesignerSitePagesDataSchema: z.ZodObject<{
-    items: z.ZodArray<z.ZodObject<{
+    groups: z.ZodArray<z.ZodObject<{
+        group_id: z.ZodString;
         title: z.ZodString;
-        route_id: z.ZodString;
+        pages: z.ZodArray<z.ZodType<import("./cms-page-directory.js").DesignerPageNode, unknown, z.core.$ZodTypeInternals<import("./cms-page-directory.js").DesignerPageNode, unknown>>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type DesignerSitePagesData = z.infer<typeof DesignerSitePagesDataSchema>;

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

@@ -0,0 +1,258 @@
+import { z } from "zod";
+/**
+ * 外部编排系统（当前是增长后台的 mastra 工作流）异步驱动改站的合同。
+ *
+ * 设计见 docs/superpowers/specs/2026-08-08-external-site-edit-api-design.md。
+ * 命名刻意不绑定具体编排器：external_run_id / external_thread_id 对应调用方
+ * 自己的运行与会话标识，VCP 只原样存储与回显，不解析其含义。
+ */
+export declare const ExternalSiteEditTaskIdSchema: z.ZodUUID;
+/** 提示词上限。改站提示词是一次任务描述，不是资料投递通道。 */
+export declare const EXTERNAL_SITE_EDIT_PROMPT_MAX_LENGTH = 4000;
+/**
+ * 结果四态。判定基准是「站点当前快照是否已推进」而非运行记录状态，
+ * 详见设计 §9.3——运行记录会在「站已改好但收口失败」时呈现为失败。
+ */
+export declare const ExternalSiteEditOutcomeSchema: z.ZodEnum<{
+    failed: "failed";
+    succeeded: "succeeded";
+    degraded: "degraded";
+    no_changes: "no_changes";
+}>;
+export type ExternalSiteEditOutcome = z.infer<typeof ExternalSiteEditOutcomeSchema>;
+/**
+ * 降级原因全集（设计 §9.4）。这些分支的共同点是：产出了真实新快照或真实副作用，
+ * 却不会让运行记录呈现为失败——即「成功外表下该改的没改成」。
+ *
+ * 注意 `sandbox_unavailable` 是唯一映射到 `failed` 的取值：沙箱起不来时那份快照
+ * 没经过任何构建校验，报成降级会让调用方以为只是有瑕疵而不再重试。
+ */
+export declare const ExternalSiteEditDegradedReasonSchema: z.ZodEnum<{
+    typecheck_unresolved: "typecheck_unresolved";
+    step_cap_reached: "step_cap_reached";
+    partial_apply_gave_up: "partial_apply_gave_up";
+    patch_protected_dropped: "patch_protected_dropped";
+    preview_build_failed: "preview_build_failed";
+    preview_runtime_degraded: "preview_runtime_degraded";
+    external_blocked: "external_blocked";
+    cms_reconcile_failed: "cms_reconcile_failed";
+    run_expired: "run_expired";
+    sandbox_unavailable: "sandbox_unavailable";
+}>;
+export type ExternalSiteEditDegradedReason = z.infer<typeof ExternalSiteEditDegradedReasonSchema>;
+/** 映射到可重试失败而非降级的原因。判定时优先于快照比对。 */
+export declare const EXTERNAL_SITE_EDIT_INFRASTRUCTURE_REASONS: readonly ExternalSiteEditDegradedReason[];
+export declare function isExternalSiteEditInfrastructureReason(reason: ExternalSiteEditDegradedReason | null | undefined): boolean;
+export declare const ExternalSiteEditCallbackStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    pending: "pending";
+    delivered: "delivered";
+}>;
+export type ExternalSiteEditCallbackStatus = z.infer<typeof ExternalSiteEditCallbackStatusSchema>;
+/** 任务状态：进行中，或四态终态之一。 */
+export declare const ExternalSiteEditTaskStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    succeeded: "succeeded";
+    running: "running";
+    degraded: "degraded";
+    no_changes: "no_changes";
+}>;
+export type ExternalSiteEditTaskStatus = z.infer<typeof ExternalSiteEditTaskStatusSchema>;
+export declare const CreateExternalSiteEditRequestSchema: z.ZodObject<{
+    site_id: z.ZodUUID;
+    external_run_id: z.ZodString;
+    external_thread_id: z.ZodString;
+    prompt: z.ZodString;
+}, z.core.$strict>;
+export type CreateExternalSiteEditRequest = z.infer<typeof CreateExternalSiteEditRequestSchema>;
+/**
+ * 任务描述符。提交接口与查询接口共用。
+ *
+ * `preview_url` 是沙箱临时地址：随沙箱回收失效、且无需凭据即可访问，
+ * 调用方不得持久化展示或公开投放（设计 §12.2）。
+ */
+export declare const ExternalSiteEditTaskSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    site_id: z.ZodUUID;
+    external_run_id: z.ZodString;
+    external_thread_id: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        succeeded: "succeeded";
+        running: "running";
+        degraded: "degraded";
+        no_changes: "no_changes";
+    }>;
+    outcome: z.ZodNullable<z.ZodEnum<{
+        failed: "failed";
+        succeeded: "succeeded";
+        degraded: "degraded";
+        no_changes: "no_changes";
+    }>>;
+    degraded_reason: z.ZodNullable<z.ZodEnum<{
+        typecheck_unresolved: "typecheck_unresolved";
+        step_cap_reached: "step_cap_reached";
+        partial_apply_gave_up: "partial_apply_gave_up";
+        patch_protected_dropped: "patch_protected_dropped";
+        preview_build_failed: "preview_build_failed";
+        preview_runtime_degraded: "preview_runtime_degraded";
+        external_blocked: "external_blocked";
+        cms_reconcile_failed: "cms_reconcile_failed";
+        run_expired: "run_expired";
+        sandbox_unavailable: "sandbox_unavailable";
+    }>>;
+    vcp_run_id: z.ZodNullable<z.ZodUUID>;
+    base_snapshot_id: z.ZodUUID;
+    snapshot_id: z.ZodNullable<z.ZodUUID>;
+    preview_url: z.ZodNullable<z.ZodString>;
+    summary: z.ZodNullable<z.ZodString>;
+    error_code: z.ZodNullable<z.ZodString>;
+    callback_status: z.ZodEnum<{
+        failed: "failed";
+        pending: "pending";
+        delivered: "delivered";
+    }>;
+    created_at: z.ZodString;
+    started_at: z.ZodNullable<z.ZodString>;
+    finished_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type ExternalSiteEditTask = z.infer<typeof ExternalSiteEditTaskSchema>;
+export declare const CreateExternalSiteEditResponseSchema: z.ZodObject<{
+    task: z.ZodObject<{
+        id: z.ZodUUID;
+        site_id: z.ZodUUID;
+        external_run_id: z.ZodString;
+        external_thread_id: z.ZodString;
+        status: z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+            running: "running";
+            degraded: "degraded";
+            no_changes: "no_changes";
+        }>;
+        outcome: z.ZodNullable<z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+            degraded: "degraded";
+            no_changes: "no_changes";
+        }>>;
+        degraded_reason: z.ZodNullable<z.ZodEnum<{
+            typecheck_unresolved: "typecheck_unresolved";
+            step_cap_reached: "step_cap_reached";
+            partial_apply_gave_up: "partial_apply_gave_up";
+            patch_protected_dropped: "patch_protected_dropped";
+            preview_build_failed: "preview_build_failed";
+            preview_runtime_degraded: "preview_runtime_degraded";
+            external_blocked: "external_blocked";
+            cms_reconcile_failed: "cms_reconcile_failed";
+            run_expired: "run_expired";
+            sandbox_unavailable: "sandbox_unavailable";
+        }>>;
+        vcp_run_id: z.ZodNullable<z.ZodUUID>;
+        base_snapshot_id: z.ZodUUID;
+        snapshot_id: z.ZodNullable<z.ZodUUID>;
+        preview_url: z.ZodNullable<z.ZodString>;
+        summary: z.ZodNullable<z.ZodString>;
+        error_code: z.ZodNullable<z.ZodString>;
+        callback_status: z.ZodEnum<{
+            failed: "failed";
+            pending: "pending";
+            delivered: "delivered";
+        }>;
+        created_at: z.ZodString;
+        started_at: z.ZodNullable<z.ZodString>;
+        finished_at: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type CreateExternalSiteEditResponse = z.infer<typeof CreateExternalSiteEditResponseSchema>;
+export declare const GetExternalSiteEditResponseSchema: z.ZodObject<{
+    task: z.ZodObject<{
+        id: z.ZodUUID;
+        site_id: z.ZodUUID;
+        external_run_id: z.ZodString;
+        external_thread_id: z.ZodString;
+        status: z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+            running: "running";
+            degraded: "degraded";
+            no_changes: "no_changes";
+        }>;
+        outcome: z.ZodNullable<z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+            degraded: "degraded";
+            no_changes: "no_changes";
+        }>>;
+        degraded_reason: z.ZodNullable<z.ZodEnum<{
+            typecheck_unresolved: "typecheck_unresolved";
+            step_cap_reached: "step_cap_reached";
+            partial_apply_gave_up: "partial_apply_gave_up";
+            patch_protected_dropped: "patch_protected_dropped";
+            preview_build_failed: "preview_build_failed";
+            preview_runtime_degraded: "preview_runtime_degraded";
+            external_blocked: "external_blocked";
+            cms_reconcile_failed: "cms_reconcile_failed";
+            run_expired: "run_expired";
+            sandbox_unavailable: "sandbox_unavailable";
+        }>>;
+        vcp_run_id: z.ZodNullable<z.ZodUUID>;
+        base_snapshot_id: z.ZodUUID;
+        snapshot_id: z.ZodNullable<z.ZodUUID>;
+        preview_url: z.ZodNullable<z.ZodString>;
+        summary: z.ZodNullable<z.ZodString>;
+        error_code: z.ZodNullable<z.ZodString>;
+        callback_status: z.ZodEnum<{
+            failed: "failed";
+            pending: "pending";
+            delivered: "delivered";
+        }>;
+        created_at: z.ZodString;
+        started_at: z.ZodNullable<z.ZodString>;
+        finished_at: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type GetExternalSiteEditResponse = z.infer<typeof GetExternalSiteEditResponseSchema>;
+/**
+ * 回调载荷。**投递语义是至少一次**：回调重试与查询接口的对账补发都可能发出同一条，
+ * 接收端必须按 task_id 幂等去重（设计 §12.1）。
+ *
+ * 安全边界：不带诊断详情、不带内部路径、不带原始追踪。`summary` 是模型自由文本，
+ * 发送前须过出站检查。
+ */
+export declare const ExternalSiteEditCallbackPayloadSchema: z.ZodObject<{
+    task_id: z.ZodUUID;
+    external_run_id: z.ZodString;
+    external_thread_id: z.ZodString;
+    site_id: z.ZodUUID;
+    vcp_run_id: z.ZodNullable<z.ZodUUID>;
+    outcome: z.ZodEnum<{
+        failed: "failed";
+        succeeded: "succeeded";
+        degraded: "degraded";
+        no_changes: "no_changes";
+    }>;
+    degraded_reason: z.ZodNullable<z.ZodEnum<{
+        typecheck_unresolved: "typecheck_unresolved";
+        step_cap_reached: "step_cap_reached";
+        partial_apply_gave_up: "partial_apply_gave_up";
+        patch_protected_dropped: "patch_protected_dropped";
+        preview_build_failed: "preview_build_failed";
+        preview_runtime_degraded: "preview_runtime_degraded";
+        external_blocked: "external_blocked";
+        cms_reconcile_failed: "cms_reconcile_failed";
+        run_expired: "run_expired";
+        sandbox_unavailable: "sandbox_unavailable";
+    }>>;
+    snapshot_id: z.ZodNullable<z.ZodUUID>;
+    preview_url: z.ZodNullable<z.ZodString>;
+    summary: z.ZodNullable<z.ZodString>;
+    error_code: z.ZodNullable<z.ZodString>;
+    retryable: z.ZodBoolean;
+    finished_at: z.ZodString;
+}, z.core.$strict>;
+export type ExternalSiteEditCallbackPayload = z.infer<typeof ExternalSiteEditCallbackPayloadSchema>;
+export declare const ExternalSiteEditCallbackAckSchema: z.ZodObject<{
+    received: z.ZodLiteral<true>;
+}, z.core.$strict>;
+export type ExternalSiteEditCallbackAck = z.infer<typeof ExternalSiteEditCallbackAckSchema>;

package/dist/firecrawl-internal.d.ts

@@ -0,0 +1,103 @@
+import { z } from "zod";
+export declare const FirecrawlJobStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    scraping: "scraping";
+    completed: "completed";
+    expired: "expired";
+}>;
+export declare const FirecrawlMapRequestSchema: z.ZodObject<{
+    url: z.ZodString;
+    ignore_cache: z.ZodBoolean;
+    sitemap: z.ZodEnum<{
+        include: "include";
+        skip: "skip";
+    }>;
+    include_subdomains: z.ZodBoolean;
+    ignore_query_parameters: z.ZodBoolean;
+    limit: z.ZodNumber;
+}, z.core.$strict>;
+export declare const FirecrawlMapResponseSchema: z.ZodObject<{
+    links: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const FirecrawlCrawlCreateRequestSchema: z.ZodObject<{
+    url: z.ZodString;
+    limit: z.ZodNumber;
+    max_discovery_depth: z.ZodLiteral<1>;
+    crawl_entire_domain: z.ZodLiteral<false>;
+    sitemap: z.ZodLiteral<"skip">;
+}, z.core.$strict>;
+export declare const FirecrawlCrawlCreatedResponseSchema: z.ZodObject<{
+    crawl_id: z.ZodString;
+    expires_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const FirecrawlCrawlStatusResponseSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        failed: "failed";
+        scraping: "scraping";
+        completed: "completed";
+        expired: "expired";
+    }>;
+    urls: z.ZodArray<z.ZodString>;
+    next: z.ZodOptional<z.ZodString>;
+    expires_at: z.ZodString;
+}, z.core.$strict>;
+export declare const FirecrawlBatchCreateRequestSchema: z.ZodObject<{
+    urls: z.ZodArray<z.ZodString>;
+    formats: z.ZodTuple<[z.ZodLiteral<"rawHtml">], null>;
+    ignore_invalid_urls: z.ZodLiteral<false>;
+    max_age: z.ZodNumber;
+    max_concurrency: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const FirecrawlBatchCreatedResponseSchema: z.ZodObject<{
+    batch_id: z.ZodString;
+    expires_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const FirecrawlBatchPageSchema: z.ZodObject<{
+    url: z.ZodString;
+    raw_html: z.ZodString;
+}, z.core.$strict>;
+export declare const FirecrawlBatchStatusResponseSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        failed: "failed";
+        scraping: "scraping";
+        completed: "completed";
+        expired: "expired";
+    }>;
+    total: z.ZodNumber;
+    completed: z.ZodNumber;
+    pages: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        raw_html: z.ZodString;
+    }, z.core.$strict>>;
+    next: z.ZodOptional<z.ZodString>;
+    expires_at: z.ZodString;
+}, z.core.$strict>;
+export declare const FirecrawlBatchErrorSchema: z.ZodObject<{
+    url: z.ZodString;
+    error_message: z.ZodString;
+}, z.core.$strict>;
+export declare const FirecrawlBatchErrorsResponseSchema: z.ZodObject<{
+    errors: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        error_message: z.ZodString;
+    }, z.core.$strict>>;
+    robots_blocked: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const FirecrawlQueueStatusResponseSchema: z.ZodObject<{
+    active: z.ZodNumber;
+    waiting: z.ZodNumber;
+    max_concurrency: z.ZodNumber;
+}, z.core.$strict>;
+export type FirecrawlJobStatus = z.infer<typeof FirecrawlJobStatusSchema>;
+export type FirecrawlMapRequest = z.infer<typeof FirecrawlMapRequestSchema>;
+export type FirecrawlMapResponse = z.infer<typeof FirecrawlMapResponseSchema>;
+export type FirecrawlCrawlCreateRequest = z.infer<typeof FirecrawlCrawlCreateRequestSchema>;
+export type FirecrawlCrawlCreatedResponse = z.infer<typeof FirecrawlCrawlCreatedResponseSchema>;
+export type FirecrawlCrawlStatusResponse = z.infer<typeof FirecrawlCrawlStatusResponseSchema>;
+export type FirecrawlBatchCreateRequest = z.infer<typeof FirecrawlBatchCreateRequestSchema>;
+export type FirecrawlBatchCreatedResponse = z.infer<typeof FirecrawlBatchCreatedResponseSchema>;
+export type FirecrawlBatchPage = z.infer<typeof FirecrawlBatchPageSchema>;
+export type FirecrawlBatchStatusResponse = z.infer<typeof FirecrawlBatchStatusResponseSchema>;
+export type FirecrawlBatchError = z.infer<typeof FirecrawlBatchErrorSchema>;
+export type FirecrawlBatchErrorsResponse = z.infer<typeof FirecrawlBatchErrorsResponseSchema>;
+export type FirecrawlQueueStatusResponse = z.infer<typeof FirecrawlQueueStatusResponseSchema>;