@vcp-dev/contracts 0.6.10 → 0.7.0

package/dist/site-workflow.d.ts

@@ -0,0 +1,1026 @@
+import { z } from "zod";
+export declare const WORKFLOW_FLOW_TYPES: readonly ["with_website", "without_website"];
+export declare const WorkflowFlowTypeSchema: z.ZodEnum<{
+    with_website: "with_website";
+    without_website: "without_website";
+}>;
+export type WorkflowFlowType = z.infer<typeof WorkflowFlowTypeSchema>;
+/** URLs that may be handed to a server-side website crawler. */
+export declare const HttpUrlSchema: z.ZodString;
+export type HttpUrl = z.infer<typeof HttpUrlSchema>;
+export declare const WORKFLOW_NODE_CODES: readonly ["welcome", "website_scan", "customer_materials", "analysis", "diagnosis", "strategy", "structure_planning", "preview_personalization", "publishing"];
+export declare const WorkflowNodeCodeSchema: z.ZodEnum<{
+    welcome: "welcome";
+    website_scan: "website_scan";
+    customer_materials: "customer_materials";
+    analysis: "analysis";
+    diagnosis: "diagnosis";
+    strategy: "strategy";
+    structure_planning: "structure_planning";
+    preview_personalization: "preview_personalization";
+    publishing: "publishing";
+}>;
+export type WorkflowNodeCode = z.infer<typeof WorkflowNodeCodeSchema>;
+export declare const WORKFLOW_TASK_TYPES: readonly ["company_info", "website_crawl", "website_basic_info_extract", "website_metrics_evaluate", "intelligent_analysis", "strategy_recommendation"];
+export declare const WorkflowTaskTypeSchema: z.ZodEnum<{
+    company_info: "company_info";
+    website_crawl: "website_crawl";
+    website_basic_info_extract: "website_basic_info_extract";
+    website_metrics_evaluate: "website_metrics_evaluate";
+    intelligent_analysis: "intelligent_analysis";
+    strategy_recommendation: "strategy_recommendation";
+}>;
+export type WorkflowTaskType = z.infer<typeof WorkflowTaskTypeSchema>;
+export declare const TASK_EXECUTION_STATUSES: readonly ["started", "running", "succeeded", "failed", "invalidated"];
+export declare const TaskExecutionStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    succeeded: "succeeded";
+    running: "running";
+    started: "started";
+    invalidated: "invalidated";
+}>;
+export type TaskExecutionStatus = z.infer<typeof TaskExecutionStatusSchema>;
+export declare const SITE_BUILD_STATUSES: readonly ["draft", "structure_saved", "generating", "workspace_ready"];
+export declare const SiteBuildStatusSchema: z.ZodEnum<{
+    draft: "draft";
+    structure_saved: "structure_saved";
+    generating: "generating";
+    workspace_ready: "workspace_ready";
+}>;
+export type SiteBuildStatus = z.infer<typeof SiteBuildStatusSchema>;
+export declare const SITE_DEPLOYMENT_STATUSES: readonly ["not_deployed", "deploying", "deployed"];
+export declare const SiteDeploymentStatusSchema: z.ZodEnum<{
+    deploying: "deploying";
+    not_deployed: "not_deployed";
+    deployed: "deployed";
+}>;
+export type SiteDeploymentStatus = z.infer<typeof SiteDeploymentStatusSchema>;
+export declare const SITE_WORKFLOW_STATUSES: readonly ["active", "completed"];
+export declare const SiteWorkflowStatusSchema: z.ZodEnum<{
+    active: "active";
+    completed: "completed";
+}>;
+export type SiteWorkflowStatus = z.infer<typeof SiteWorkflowStatusSchema>;
+export declare const WORKFLOW_MENU_STATES: readonly ["completed", "current", "locked"];
+export declare const WorkflowMenuStateSchema: z.ZodEnum<{
+    completed: "completed";
+    current: "current";
+    locked: "locked";
+}>;
+export type WorkflowMenuState = z.infer<typeof WorkflowMenuStateSchema>;
+export declare const SITE_BUILD_STATUS_CODES: {
+    readonly draft: 10;
+    readonly structure_saved: 20;
+    readonly generating: 30;
+    readonly workspace_ready: 40;
+};
+export declare const SITE_DEPLOYMENT_STATUS_CODES: {
+    readonly not_deployed: 10;
+    readonly deploying: 20;
+    readonly deployed: 30;
+};
+export declare const SITE_WORKFLOW_STATUS_CODES: {
+    readonly active: 10;
+    readonly completed: 20;
+};
+export declare const TASK_EXECUTION_STATUS_CODES: {
+    readonly started: 10;
+    readonly running: 20;
+    readonly succeeded: 30;
+    readonly failed: 40;
+    readonly invalidated: 50;
+};
+export declare function siteBuildStatusFromCode(code: number): SiteBuildStatus;
+export declare function siteDeploymentStatusFromCode(code: number): SiteDeploymentStatus;
+export declare function siteWorkflowStatusFromCode(code: number): SiteWorkflowStatus;
+export declare function taskExecutionStatusFromCode(code: number): TaskExecutionStatus;
+export declare function siteBuildStatusToCode(status: SiteBuildStatus): number;
+export declare function siteDeploymentStatusToCode(status: SiteDeploymentStatus): number;
+export declare function siteWorkflowStatusToCode(status: SiteWorkflowStatus): number;
+export declare function taskExecutionStatusToCode(status: TaskExecutionStatus): number;
+export interface WorkflowDefinitionNode {
+    readonly id: string;
+    readonly node_code: WorkflowNodeCode;
+    readonly label: string;
+    readonly sort_order: number;
+    readonly is_enabled: true;
+}
+export interface WorkflowDefinitionRegistryEntry {
+    readonly definition_version: number;
+    readonly published: boolean;
+    readonly required_client_capability: string | null;
+    readonly definitions: Readonly<Record<WorkflowFlowType, readonly WorkflowDefinitionNode[]>>;
+}
+/**
+ * Versioned, checked-in workflow definitions. `published` controls admission
+ * for new workflows; exact-version lookup intentionally ignores it so an
+ * existing workflow can survive a two-stage code release.
+ */
+export declare const WORKFLOW_DEFINITION_REGISTRY: readonly [{
+    readonly definition_version: 1;
+    readonly published: true;
+    readonly required_client_capability: null;
+    readonly definitions: {
+        readonly with_website: readonly [{
+            readonly id: "01900000-0000-7000-8000-000000000001";
+            readonly node_code: "welcome";
+            readonly label: "欢迎启动";
+            readonly sort_order: 1;
+            readonly is_enabled: true;
+        }, {
+            readonly id: "01900000-0000-7000-8000-000000000002";
+            readonly node_code: "website_scan";
+            readonly label: "初始化需求与官网扫描";
+            readonly sort_order: 2;
+            readonly is_enabled: true;
+        }, {
+            readonly id: "01900000-0000-7000-8000-000000000003";
+            readonly node_code: "analysis";
+            readonly label: "智能分析";
+            readonly sort_order: 3;
+            readonly is_enabled: true;
+        }, {
+            readonly id: "01900000-0000-7000-8000-000000000004";
+            readonly node_code: "diagnosis";
+            readonly label: "诊断报告";
+            readonly sort_order: 4;
+            readonly is_enabled: true;
+        }, {
+            readonly id: "01900000-0000-7000-8000-000000000005";
+            readonly node_code: "strategy";
+            readonly label: "策略与建议";
+            readonly sort_order: 5;
+            readonly is_enabled: true;
+        }, {
+            readonly id: "01900000-0000-7000-8000-000000000014";
+            readonly node_code: "structure_planning";
+            readonly label: "结构规划";
+            readonly sort_order: 6;
+            readonly is_enabled: true;
+        }, {
+            readonly id: "01900000-0000-7000-8000-000000000015";
+            readonly node_code: "preview_personalization";
+            readonly label: "预览与个性化";
+            readonly sort_order: 7;
+            readonly is_enabled: true;
+        }, {
+            readonly id: "01900000-0000-7000-8000-000000000016";
+            readonly node_code: "publishing";
+            readonly label: "网站发布";
+            readonly sort_order: 8;
+            readonly is_enabled: true;
+        }];
+        readonly without_website: readonly [{
+            readonly id: "01900000-0000-7000-8000-00000000000b";
+            readonly node_code: "welcome";
+            readonly label: "欢迎启动";
+            readonly sort_order: 1;
+            readonly is_enabled: true;
+        }, {
+            readonly id: "01900000-0000-7000-8000-00000000000c";
+            readonly node_code: "customer_materials";
+            readonly label: "客户资料提供";
+            readonly sort_order: 2;
+            readonly is_enabled: true;
+        }, {
+            readonly id: "01900000-0000-7000-8000-00000000000d";
+            readonly node_code: "analysis";
+            readonly label: "智能分析";
+            readonly sort_order: 3;
+            readonly is_enabled: true;
+        }, {
+            readonly id: "01900000-0000-7000-8000-00000000000e";
+            readonly node_code: "strategy";
+            readonly label: "策略与建议";
+            readonly sort_order: 4;
+            readonly is_enabled: true;
+        }, {
+            readonly id: "01900000-0000-7000-8000-000000000017";
+            readonly node_code: "structure_planning";
+            readonly label: "结构规划";
+            readonly sort_order: 5;
+            readonly is_enabled: true;
+        }, {
+            readonly id: "01900000-0000-7000-8000-000000000018";
+            readonly node_code: "preview_personalization";
+            readonly label: "预览与个性化";
+            readonly sort_order: 6;
+            readonly is_enabled: true;
+        }, {
+            readonly id: "01900000-0000-7000-8000-000000000019";
+            readonly node_code: "publishing";
+            readonly label: "网站发布";
+            readonly sort_order: 7;
+            readonly is_enabled: true;
+        }];
+    };
+}];
+/** Compatibility view retained for existing contract consumers. */
+export declare const WORKFLOW_DEFINITIONS_V1: {
+    readonly with_website: readonly [{
+        readonly id: "01900000-0000-7000-8000-000000000001";
+        readonly node_code: "welcome";
+        readonly label: "欢迎启动";
+        readonly sort_order: 1;
+        readonly is_enabled: true;
+    }, {
+        readonly id: "01900000-0000-7000-8000-000000000002";
+        readonly node_code: "website_scan";
+        readonly label: "初始化需求与官网扫描";
+        readonly sort_order: 2;
+        readonly is_enabled: true;
+    }, {
+        readonly id: "01900000-0000-7000-8000-000000000003";
+        readonly node_code: "analysis";
+        readonly label: "智能分析";
+        readonly sort_order: 3;
+        readonly is_enabled: true;
+    }, {
+        readonly id: "01900000-0000-7000-8000-000000000004";
+        readonly node_code: "diagnosis";
+        readonly label: "诊断报告";
+        readonly sort_order: 4;
+        readonly is_enabled: true;
+    }, {
+        readonly id: "01900000-0000-7000-8000-000000000005";
+        readonly node_code: "strategy";
+        readonly label: "策略与建议";
+        readonly sort_order: 5;
+        readonly is_enabled: true;
+    }, {
+        readonly id: "01900000-0000-7000-8000-000000000014";
+        readonly node_code: "structure_planning";
+        readonly label: "结构规划";
+        readonly sort_order: 6;
+        readonly is_enabled: true;
+    }, {
+        readonly id: "01900000-0000-7000-8000-000000000015";
+        readonly node_code: "preview_personalization";
+        readonly label: "预览与个性化";
+        readonly sort_order: 7;
+        readonly is_enabled: true;
+    }, {
+        readonly id: "01900000-0000-7000-8000-000000000016";
+        readonly node_code: "publishing";
+        readonly label: "网站发布";
+        readonly sort_order: 8;
+        readonly is_enabled: true;
+    }];
+    readonly without_website: readonly [{
+        readonly id: "01900000-0000-7000-8000-00000000000b";
+        readonly node_code: "welcome";
+        readonly label: "欢迎启动";
+        readonly sort_order: 1;
+        readonly is_enabled: true;
+    }, {
+        readonly id: "01900000-0000-7000-8000-00000000000c";
+        readonly node_code: "customer_materials";
+        readonly label: "客户资料提供";
+        readonly sort_order: 2;
+        readonly is_enabled: true;
+    }, {
+        readonly id: "01900000-0000-7000-8000-00000000000d";
+        readonly node_code: "analysis";
+        readonly label: "智能分析";
+        readonly sort_order: 3;
+        readonly is_enabled: true;
+    }, {
+        readonly id: "01900000-0000-7000-8000-00000000000e";
+        readonly node_code: "strategy";
+        readonly label: "策略与建议";
+        readonly sort_order: 4;
+        readonly is_enabled: true;
+    }, {
+        readonly id: "01900000-0000-7000-8000-000000000017";
+        readonly node_code: "structure_planning";
+        readonly label: "结构规划";
+        readonly sort_order: 5;
+        readonly is_enabled: true;
+    }, {
+        readonly id: "01900000-0000-7000-8000-000000000018";
+        readonly node_code: "preview_personalization";
+        readonly label: "预览与个性化";
+        readonly sort_order: 6;
+        readonly is_enabled: true;
+    }, {
+        readonly id: "01900000-0000-7000-8000-000000000019";
+        readonly node_code: "publishing";
+        readonly label: "网站发布";
+        readonly sort_order: 7;
+        readonly is_enabled: true;
+    }];
+};
+export declare const WorkflowDefinitionVersionSchema: z.ZodNumber;
+export declare const WorkflowMenuItemSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    flow_type: z.ZodEnum<{
+        with_website: "with_website";
+        without_website: "without_website";
+    }>;
+    definition_version: z.ZodNumber;
+    node_code: z.ZodEnum<{
+        welcome: "welcome";
+        website_scan: "website_scan";
+        customer_materials: "customer_materials";
+        analysis: "analysis";
+        diagnosis: "diagnosis";
+        strategy: "strategy";
+        structure_planning: "structure_planning";
+        preview_personalization: "preview_personalization";
+        publishing: "publishing";
+    }>;
+    label: z.ZodString;
+    sort_order: z.ZodNumber;
+    is_enabled: z.ZodBoolean;
+    state: z.ZodEnum<{
+        completed: "completed";
+        current: "current";
+        locked: "locked";
+    }>;
+}, z.core.$strip>;
+export type WorkflowMenuItem = z.infer<typeof WorkflowMenuItemSchema>;
+export declare const SiteWorkflowTaskRefSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    tenant_id: z.ZodString;
+    site_id: z.ZodUUID;
+    workflow_id: z.ZodUUID;
+    node_code: z.ZodEnum<{
+        welcome: "welcome";
+        website_scan: "website_scan";
+        customer_materials: "customer_materials";
+        analysis: "analysis";
+        diagnosis: "diagnosis";
+        strategy: "strategy";
+        structure_planning: "structure_planning";
+        preview_personalization: "preview_personalization";
+        publishing: "publishing";
+    }>;
+    task_type: z.ZodEnum<{
+        company_info: "company_info";
+        website_crawl: "website_crawl";
+        website_basic_info_extract: "website_basic_info_extract";
+        website_metrics_evaluate: "website_metrics_evaluate";
+        intelligent_analysis: "intelligent_analysis";
+        strategy_recommendation: "strategy_recommendation";
+    }>;
+    external_task_id: z.ZodString;
+    execution_status: z.ZodEnum<{
+        failed: "failed";
+        succeeded: "succeeded";
+        running: "running";
+        started: "started";
+        invalidated: "invalidated";
+    }>;
+    idempotency_key: z.ZodString;
+    attempt_no: z.ZodNumber;
+    superseded_at: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+export type SiteWorkflowTaskRef = z.infer<typeof SiteWorkflowTaskRefSchema>;
+export declare const SiteWorkflowRecordSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    tenant_id: z.ZodString;
+    site_id: z.ZodUUID;
+    flow_type: z.ZodEnum<{
+        with_website: "with_website";
+        without_website: "without_website";
+    }>;
+    website: z.ZodNullable<z.ZodString>;
+    definition_version: z.ZodNumber;
+    current_node_code: z.ZodEnum<{
+        welcome: "welcome";
+        website_scan: "website_scan";
+        customer_materials: "customer_materials";
+        analysis: "analysis";
+        diagnosis: "diagnosis";
+        strategy: "strategy";
+        structure_planning: "structure_planning";
+        preview_personalization: "preview_personalization";
+        publishing: "publishing";
+    }>;
+    status: z.ZodEnum<{
+        active: "active";
+        completed: "completed";
+    }>;
+    started_at: z.ZodString;
+    completed_at: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+export type SiteWorkflowRecord = z.infer<typeof SiteWorkflowRecordSchema>;
+export declare const SiteWorkflowSnapshotSchema: z.ZodObject<{
+    workflow: z.ZodObject<{
+        id: z.ZodUUID;
+        tenant_id: z.ZodString;
+        site_id: z.ZodUUID;
+        flow_type: z.ZodEnum<{
+            with_website: "with_website";
+            without_website: "without_website";
+        }>;
+        website: z.ZodNullable<z.ZodString>;
+        definition_version: z.ZodNumber;
+        current_node_code: z.ZodEnum<{
+            welcome: "welcome";
+            website_scan: "website_scan";
+            customer_materials: "customer_materials";
+            analysis: "analysis";
+            diagnosis: "diagnosis";
+            strategy: "strategy";
+            structure_planning: "structure_planning";
+            preview_personalization: "preview_personalization";
+            publishing: "publishing";
+        }>;
+        status: z.ZodEnum<{
+            active: "active";
+            completed: "completed";
+        }>;
+        started_at: z.ZodString;
+        completed_at: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strip>;
+    menu: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        flow_type: z.ZodEnum<{
+            with_website: "with_website";
+            without_website: "without_website";
+        }>;
+        definition_version: z.ZodNumber;
+        node_code: z.ZodEnum<{
+            welcome: "welcome";
+            website_scan: "website_scan";
+            customer_materials: "customer_materials";
+            analysis: "analysis";
+            diagnosis: "diagnosis";
+            strategy: "strategy";
+            structure_planning: "structure_planning";
+            preview_personalization: "preview_personalization";
+            publishing: "publishing";
+        }>;
+        label: z.ZodString;
+        sort_order: z.ZodNumber;
+        is_enabled: z.ZodBoolean;
+        state: z.ZodEnum<{
+            completed: "completed";
+            current: "current";
+            locked: "locked";
+        }>;
+    }, z.core.$strip>>;
+    task_refs: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        tenant_id: z.ZodString;
+        site_id: z.ZodUUID;
+        workflow_id: z.ZodUUID;
+        node_code: z.ZodEnum<{
+            welcome: "welcome";
+            website_scan: "website_scan";
+            customer_materials: "customer_materials";
+            analysis: "analysis";
+            diagnosis: "diagnosis";
+            strategy: "strategy";
+            structure_planning: "structure_planning";
+            preview_personalization: "preview_personalization";
+            publishing: "publishing";
+        }>;
+        task_type: z.ZodEnum<{
+            company_info: "company_info";
+            website_crawl: "website_crawl";
+            website_basic_info_extract: "website_basic_info_extract";
+            website_metrics_evaluate: "website_metrics_evaluate";
+            intelligent_analysis: "intelligent_analysis";
+            strategy_recommendation: "strategy_recommendation";
+        }>;
+        external_task_id: z.ZodString;
+        execution_status: z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+            running: "running";
+            started: "started";
+            invalidated: "invalidated";
+        }>;
+        idempotency_key: z.ZodString;
+        attempt_no: z.ZodNumber;
+        superseded_at: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strip>>;
+    site: z.ZodObject<{
+        default_locale: z.ZodOptional<z.ZodEnum<{
+            id: "id";
+            "zh-CN": "zh-CN";
+            "zh-HK": "zh-HK";
+            "zh-TW": "zh-TW";
+            "en-US": "en-US";
+            "en-GB": "en-GB";
+            "ja-JP": "ja-JP";
+            "ko-KR": "ko-KR";
+            "es-ES": "es-ES";
+            "fr-FR": "fr-FR";
+            "de-DE": "de-DE";
+            "pt-PT": "pt-PT";
+            "ru-RU": "ru-RU";
+            "ar-SA": "ar-SA";
+            "id-ID": "id-ID";
+            "vi-VN": "vi-VN";
+            "th-TH": "th-TH";
+            "it-IT": "it-IT";
+            "nl-NL": "nl-NL";
+            "tr-TR": "tr-TR";
+            "pl-PL": "pl-PL";
+            "uk-UA": "uk-UA";
+            "cs-CZ": "cs-CZ";
+            "sk-SK": "sk-SK";
+            "hu-HU": "hu-HU";
+            "ro-RO": "ro-RO";
+            "el-GR": "el-GR";
+            "sv-SE": "sv-SE";
+            "da-DK": "da-DK";
+            "fi-FI": "fi-FI";
+            "hr-HR": "hr-HR";
+            "lt-LT": "lt-LT";
+            "lv-LV": "lv-LV";
+            "et-EE": "et-EE";
+            "ga-IE": "ga-IE";
+            "mt-MT": "mt-MT";
+            "ka-GE": "ka-GE";
+            "fa-IR": "fa-IR";
+            "bn-BD": "bn-BD";
+            "ta-IN": "ta-IN";
+            "si-LK": "si-LK";
+            "ms-MY": "ms-MY";
+            "fil-PH": "fil-PH";
+            "my-MM": "my-MM";
+            "km-KH": "km-KH";
+            "lo-LA": "lo-LA";
+            "mn-MN": "mn-MN";
+            "kk-KZ": "kk-KZ";
+            en: "en";
+            ja: "ja";
+            es: "es";
+            fr: "fr";
+            de: "de";
+            ko: "ko";
+            pt: "pt";
+            "pt-BR": "pt-BR";
+            it: "it";
+            ru: "ru";
+            ar: "ar";
+            hi: "hi";
+            vi: "vi";
+            th: "th";
+            tr: "tr";
+            nl: "nl";
+            pl: "pl";
+            uk: "uk";
+            sv: "sv";
+            da: "da";
+            fi: "fi";
+            no: "no";
+            cs: "cs";
+            el: "el";
+            hu: "hu";
+            ro: "ro";
+            he: "he";
+            ms: "ms";
+            fil: "fil";
+            bn: "bn";
+            ta: "ta";
+            ca: "ca";
+            sk: "sk";
+            hr: "hr";
+            bg: "bg";
+            lt: "lt";
+            lv: "lv";
+            et: "et";
+            fa: "fa";
+            sw: "sw";
+            sr: "sr";
+            is: "is";
+        }>>;
+        status: z.ZodEnum<{
+            draft: "draft";
+            structure_saved: "structure_saved";
+            generating: "generating";
+            workspace_ready: "workspace_ready";
+        }>;
+        deployment_status: z.ZodEnum<{
+            deploying: "deploying";
+            not_deployed: "not_deployed";
+            deployed: "deployed";
+        }>;
+        archived_at: z.ZodNullable<z.ZodString>;
+        current_sitemap_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        current_sitemap_version: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        confirmed_sitemap_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        confirmed_sitemap_version: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        structure_confirmed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        current_snapshot_id: z.ZodNullable<z.ZodString>;
+        deployed_url: z.ZodNullable<z.ZodString>;
+        cms_site_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SiteWorkflowSnapshot = z.infer<typeof SiteWorkflowSnapshotSchema>;
+export declare const SiteWorkflowSnapshotResponseSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    data: z.ZodObject<{
+        workflow: z.ZodObject<{
+            id: z.ZodUUID;
+            tenant_id: z.ZodString;
+            site_id: z.ZodUUID;
+            flow_type: z.ZodEnum<{
+                with_website: "with_website";
+                without_website: "without_website";
+            }>;
+            website: z.ZodNullable<z.ZodString>;
+            definition_version: z.ZodNumber;
+            current_node_code: z.ZodEnum<{
+                welcome: "welcome";
+                website_scan: "website_scan";
+                customer_materials: "customer_materials";
+                analysis: "analysis";
+                diagnosis: "diagnosis";
+                strategy: "strategy";
+                structure_planning: "structure_planning";
+                preview_personalization: "preview_personalization";
+                publishing: "publishing";
+            }>;
+            status: z.ZodEnum<{
+                active: "active";
+                completed: "completed";
+            }>;
+            started_at: z.ZodString;
+            completed_at: z.ZodNullable<z.ZodString>;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+        }, z.core.$strip>;
+        menu: z.ZodArray<z.ZodObject<{
+            id: z.ZodUUID;
+            flow_type: z.ZodEnum<{
+                with_website: "with_website";
+                without_website: "without_website";
+            }>;
+            definition_version: z.ZodNumber;
+            node_code: z.ZodEnum<{
+                welcome: "welcome";
+                website_scan: "website_scan";
+                customer_materials: "customer_materials";
+                analysis: "analysis";
+                diagnosis: "diagnosis";
+                strategy: "strategy";
+                structure_planning: "structure_planning";
+                preview_personalization: "preview_personalization";
+                publishing: "publishing";
+            }>;
+            label: z.ZodString;
+            sort_order: z.ZodNumber;
+            is_enabled: z.ZodBoolean;
+            state: z.ZodEnum<{
+                completed: "completed";
+                current: "current";
+                locked: "locked";
+            }>;
+        }, z.core.$strip>>;
+        task_refs: z.ZodArray<z.ZodObject<{
+            id: z.ZodUUID;
+            tenant_id: z.ZodString;
+            site_id: z.ZodUUID;
+            workflow_id: z.ZodUUID;
+            node_code: z.ZodEnum<{
+                welcome: "welcome";
+                website_scan: "website_scan";
+                customer_materials: "customer_materials";
+                analysis: "analysis";
+                diagnosis: "diagnosis";
+                strategy: "strategy";
+                structure_planning: "structure_planning";
+                preview_personalization: "preview_personalization";
+                publishing: "publishing";
+            }>;
+            task_type: z.ZodEnum<{
+                company_info: "company_info";
+                website_crawl: "website_crawl";
+                website_basic_info_extract: "website_basic_info_extract";
+                website_metrics_evaluate: "website_metrics_evaluate";
+                intelligent_analysis: "intelligent_analysis";
+                strategy_recommendation: "strategy_recommendation";
+            }>;
+            external_task_id: z.ZodString;
+            execution_status: z.ZodEnum<{
+                failed: "failed";
+                succeeded: "succeeded";
+                running: "running";
+                started: "started";
+                invalidated: "invalidated";
+            }>;
+            idempotency_key: z.ZodString;
+            attempt_no: z.ZodNumber;
+            superseded_at: z.ZodNullable<z.ZodString>;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+        }, z.core.$strip>>;
+        site: z.ZodObject<{
+            default_locale: z.ZodOptional<z.ZodEnum<{
+                id: "id";
+                "zh-CN": "zh-CN";
+                "zh-HK": "zh-HK";
+                "zh-TW": "zh-TW";
+                "en-US": "en-US";
+                "en-GB": "en-GB";
+                "ja-JP": "ja-JP";
+                "ko-KR": "ko-KR";
+                "es-ES": "es-ES";
+                "fr-FR": "fr-FR";
+                "de-DE": "de-DE";
+                "pt-PT": "pt-PT";
+                "ru-RU": "ru-RU";
+                "ar-SA": "ar-SA";
+                "id-ID": "id-ID";
+                "vi-VN": "vi-VN";
+                "th-TH": "th-TH";
+                "it-IT": "it-IT";
+                "nl-NL": "nl-NL";
+                "tr-TR": "tr-TR";
+                "pl-PL": "pl-PL";
+                "uk-UA": "uk-UA";
+                "cs-CZ": "cs-CZ";
+                "sk-SK": "sk-SK";
+                "hu-HU": "hu-HU";
+                "ro-RO": "ro-RO";
+                "el-GR": "el-GR";
+                "sv-SE": "sv-SE";
+                "da-DK": "da-DK";
+                "fi-FI": "fi-FI";
+                "hr-HR": "hr-HR";
+                "lt-LT": "lt-LT";
+                "lv-LV": "lv-LV";
+                "et-EE": "et-EE";
+                "ga-IE": "ga-IE";
+                "mt-MT": "mt-MT";
+                "ka-GE": "ka-GE";
+                "fa-IR": "fa-IR";
+                "bn-BD": "bn-BD";
+                "ta-IN": "ta-IN";
+                "si-LK": "si-LK";
+                "ms-MY": "ms-MY";
+                "fil-PH": "fil-PH";
+                "my-MM": "my-MM";
+                "km-KH": "km-KH";
+                "lo-LA": "lo-LA";
+                "mn-MN": "mn-MN";
+                "kk-KZ": "kk-KZ";
+                en: "en";
+                ja: "ja";
+                es: "es";
+                fr: "fr";
+                de: "de";
+                ko: "ko";
+                pt: "pt";
+                "pt-BR": "pt-BR";
+                it: "it";
+                ru: "ru";
+                ar: "ar";
+                hi: "hi";
+                vi: "vi";
+                th: "th";
+                tr: "tr";
+                nl: "nl";
+                pl: "pl";
+                uk: "uk";
+                sv: "sv";
+                da: "da";
+                fi: "fi";
+                no: "no";
+                cs: "cs";
+                el: "el";
+                hu: "hu";
+                ro: "ro";
+                he: "he";
+                ms: "ms";
+                fil: "fil";
+                bn: "bn";
+                ta: "ta";
+                ca: "ca";
+                sk: "sk";
+                hr: "hr";
+                bg: "bg";
+                lt: "lt";
+                lv: "lv";
+                et: "et";
+                fa: "fa";
+                sw: "sw";
+                sr: "sr";
+                is: "is";
+            }>>;
+            status: z.ZodEnum<{
+                draft: "draft";
+                structure_saved: "structure_saved";
+                generating: "generating";
+                workspace_ready: "workspace_ready";
+            }>;
+            deployment_status: z.ZodEnum<{
+                deploying: "deploying";
+                not_deployed: "not_deployed";
+                deployed: "deployed";
+            }>;
+            archived_at: z.ZodNullable<z.ZodString>;
+            current_sitemap_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            current_sitemap_version: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            confirmed_sitemap_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            confirmed_sitemap_version: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            structure_confirmed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            current_snapshot_id: z.ZodNullable<z.ZodString>;
+            deployed_url: z.ZodNullable<z.ZodString>;
+            cms_site_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export type SiteWorkflowSnapshotResponse = z.infer<typeof SiteWorkflowSnapshotResponseSchema>;
+export declare const SiteWorkflowTaskRefResponseSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    data: z.ZodObject<{
+        id: z.ZodUUID;
+        tenant_id: z.ZodString;
+        site_id: z.ZodUUID;
+        workflow_id: z.ZodUUID;
+        node_code: z.ZodEnum<{
+            welcome: "welcome";
+            website_scan: "website_scan";
+            customer_materials: "customer_materials";
+            analysis: "analysis";
+            diagnosis: "diagnosis";
+            strategy: "strategy";
+            structure_planning: "structure_planning";
+            preview_personalization: "preview_personalization";
+            publishing: "publishing";
+        }>;
+        task_type: z.ZodEnum<{
+            company_info: "company_info";
+            website_crawl: "website_crawl";
+            website_basic_info_extract: "website_basic_info_extract";
+            website_metrics_evaluate: "website_metrics_evaluate";
+            intelligent_analysis: "intelligent_analysis";
+            strategy_recommendation: "strategy_recommendation";
+        }>;
+        external_task_id: z.ZodString;
+        execution_status: z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+            running: "running";
+            started: "started";
+            invalidated: "invalidated";
+        }>;
+        idempotency_key: z.ZodString;
+        attempt_no: z.ZodNumber;
+        superseded_at: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strip>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export type SiteWorkflowTaskRefResponse = z.infer<typeof SiteWorkflowTaskRefResponseSchema>;
+/**
+ * What the calling bundle can actually drive. Purely a compatibility signal for
+ * choosing a definition version — it never grants permission, and the server
+ * ignores it for tenant or role checks. Optional so an older bundle keeps
+ * creating workflows unchanged.
+ */
+export declare const WorkflowClientCapabilitiesSchema: z.ZodOptional<z.ZodArray<z.ZodString>>;
+export declare const CreateSiteWorkflowRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    flow_type: z.ZodLiteral<"with_website">;
+    website: z.ZodString;
+    client_capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    flow_type: z.ZodLiteral<"without_website">;
+    website: z.ZodOptional<z.ZodNull>;
+    client_capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>], "flow_type">;
+export type CreateSiteWorkflowRequest = z.infer<typeof CreateSiteWorkflowRequestSchema>;
+export declare const UpdateSiteWorkflowWebsiteRequestSchema: z.ZodObject<{
+    expected_current_node: z.ZodLiteral<"website_scan">;
+    website: z.ZodString;
+}, z.core.$strict>;
+export type UpdateSiteWorkflowWebsiteRequest = z.infer<typeof UpdateSiteWorkflowWebsiteRequestSchema>;
+export declare const AdvanceSiteWorkflowRequestSchema: z.ZodObject<{
+    expected_current_node: z.ZodEnum<{
+        welcome: "welcome";
+        website_scan: "website_scan";
+        customer_materials: "customer_materials";
+        analysis: "analysis";
+        diagnosis: "diagnosis";
+        strategy: "strategy";
+        structure_planning: "structure_planning";
+        preview_personalization: "preview_personalization";
+        publishing: "publishing";
+    }>;
+}, z.core.$strict>;
+export type AdvanceSiteWorkflowRequest = z.infer<typeof AdvanceSiteWorkflowRequestSchema>;
+export declare const CompleteSiteWorkflowRequestSchema: z.ZodObject<{
+    expected_current_node: z.ZodLiteral<"publishing">;
+}, z.core.$strict>;
+export type CompleteSiteWorkflowRequest = z.infer<typeof CompleteSiteWorkflowRequestSchema>;
+export declare const RegisterWorkflowTaskRequestSchema: z.ZodObject<{
+    node_code: z.ZodEnum<{
+        welcome: "welcome";
+        website_scan: "website_scan";
+        customer_materials: "customer_materials";
+        analysis: "analysis";
+        diagnosis: "diagnosis";
+        strategy: "strategy";
+        structure_planning: "structure_planning";
+        preview_personalization: "preview_personalization";
+        publishing: "publishing";
+    }>;
+    task_type: z.ZodEnum<{
+        company_info: "company_info";
+        website_crawl: "website_crawl";
+        website_basic_info_extract: "website_basic_info_extract";
+        website_metrics_evaluate: "website_metrics_evaluate";
+        intelligent_analysis: "intelligent_analysis";
+        strategy_recommendation: "strategy_recommendation";
+    }>;
+    external_task_id: z.ZodString;
+    idempotency_key: z.ZodString;
+}, z.core.$strip>;
+export type RegisterWorkflowTaskRequest = z.infer<typeof RegisterWorkflowTaskRequestSchema>;
+/** HTTP command DTOs include workflow_id because it is not part of the URL. */
+export declare const RegisterWorkflowTaskCommandRequestSchema: z.ZodObject<{
+    node_code: z.ZodEnum<{
+        welcome: "welcome";
+        website_scan: "website_scan";
+        customer_materials: "customer_materials";
+        analysis: "analysis";
+        diagnosis: "diagnosis";
+        strategy: "strategy";
+        structure_planning: "structure_planning";
+        preview_personalization: "preview_personalization";
+        publishing: "publishing";
+    }>;
+    task_type: z.ZodEnum<{
+        company_info: "company_info";
+        website_crawl: "website_crawl";
+        website_basic_info_extract: "website_basic_info_extract";
+        website_metrics_evaluate: "website_metrics_evaluate";
+        intelligent_analysis: "intelligent_analysis";
+        strategy_recommendation: "strategy_recommendation";
+    }>;
+    external_task_id: z.ZodString;
+    idempotency_key: z.ZodString;
+    workflow_id: z.ZodUUID;
+}, z.core.$strict>;
+export type RegisterWorkflowTaskCommandRequest = z.infer<typeof RegisterWorkflowTaskCommandRequestSchema>;
+export declare const UpdateWorkflowTaskStatusRequestSchema: z.ZodObject<{
+    external_task_id: z.ZodString;
+    execution_status: z.ZodEnum<{
+        failed: "failed";
+        succeeded: "succeeded";
+        running: "running";
+        started: "started";
+        invalidated: "invalidated";
+    }>;
+}, z.core.$strip>;
+export type UpdateWorkflowTaskStatusRequest = z.infer<typeof UpdateWorkflowTaskStatusRequestSchema>;
+export declare const ReplaceWorkflowTaskRequestSchema: z.ZodObject<{
+    previous_external_task_id: z.ZodString;
+    external_task_id: z.ZodString;
+    idempotency_key: z.ZodString;
+}, z.core.$strip>;
+export type ReplaceWorkflowTaskRequest = z.infer<typeof ReplaceWorkflowTaskRequestSchema>;
+export declare const ReplaceWorkflowTaskCommandRequestSchema: z.ZodObject<{
+    previous_external_task_id: z.ZodString;
+    external_task_id: z.ZodString;
+    idempotency_key: z.ZodString;
+    workflow_id: z.ZodUUID;
+}, z.core.$strict>;
+export type ReplaceWorkflowTaskCommandRequest = z.infer<typeof ReplaceWorkflowTaskCommandRequestSchema>;
+export declare const ReplaceCrawlWorkflowTaskRequestSchema: z.ZodObject<{
+    previous_external_task_id: z.ZodString;
+    external_task_id: z.ZodString;
+    idempotency_key: z.ZodString;
+}, z.core.$strip>;
+export type ReplaceCrawlWorkflowTaskRequest = z.infer<typeof ReplaceCrawlWorkflowTaskRequestSchema>;
+export declare const ReplaceCrawlWorkflowTaskCommandRequestSchema: z.ZodObject<{
+    previous_external_task_id: z.ZodString;
+    external_task_id: z.ZodString;
+    idempotency_key: z.ZodString;
+    workflow_id: z.ZodUUID;
+}, z.core.$strict>;
+export type ReplaceCrawlWorkflowTaskCommandRequest = z.infer<typeof ReplaceCrawlWorkflowTaskCommandRequestSchema>;
+export declare const StartSiteBuildRequestSchema: z.ZodObject<{}, z.core.$strict>;
+export type StartSiteBuildRequest = z.infer<typeof StartSiteBuildRequestSchema>;
+export declare function findWorkflowDefinitionInRegistry(registry: readonly WorkflowDefinitionRegistryEntry[], flow_type: WorkflowFlowType, definition_version: number): readonly WorkflowDefinitionNode[] | undefined;
+export declare function findWorkflowDefinition(flow_type: WorkflowFlowType, definition_version: number): readonly WorkflowDefinitionNode[] | undefined;
+export declare function getWorkflowDefinition(flow_type: WorkflowFlowType, definition_version?: number): readonly WorkflowDefinitionNode[];
+export declare function selectPublishedWorkflowDefinition(registry: readonly WorkflowDefinitionRegistryEntry[], flow_type: WorkflowFlowType, client_capabilities: readonly string[]): {
+    readonly definition_version: number;
+    readonly items: readonly WorkflowDefinitionNode[];
+} | undefined;
+export declare function resolvePublishedWorkflowDefinition(flow_type: WorkflowFlowType, client_capabilities: readonly string[]): {
+    readonly definition_version: number;
+    readonly items: readonly WorkflowDefinitionNode[];
+} | undefined;
+export declare function getWorkflowNodeIndex(flow_type: WorkflowFlowType, node_code: WorkflowNodeCode): number;
+export declare function isWorkflowTaskTypeForNode(node_code: WorkflowNodeCode, task_type: WorkflowTaskType): boolean;
+export declare function assertTaskExecutionStatusTransition(from: TaskExecutionStatus, to: TaskExecutionStatus): TaskExecutionStatus;
+export declare function assertSiteBuildStatusTransition(from: SiteBuildStatus, to: SiteBuildStatus): SiteBuildStatus;