@vcp-dev/contracts 0.9.3 → 0.9.5

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export * from "./designer-page-library.js";
 export * from "./component-i18n-resources.js";
 export * from "./migration-products.js";
 export { PLATFORM_OWNED_PAGE_SLUGS, PLATFORM_OWNED_ROUTE_FILE_PATHS, PAGE_SLUG_PATTERN, PAGE_SLUG_SEGMENT_PATTERN_SOURCE, canonicalizePageSlug, isCanonicalPageSlug, pageSlugToRouteFilePath, tryCanonicalizeAsciiPageSlug, } from "./page-slug.js";
+export * from "./site-deletion-blockers.js";
 export * from "./site-edit-capability.js";
 export * from "./site-edit-class-name-source.js";
 export * from "./site-edit-composition.js";
@@ -54,6 +55,7 @@ export * from "./customer-materials.js";
 export * from "./step2-site-initialization.js";
 export * from "./step5-strategy.js";
 export * from "./step6-design.js";
+export * from "./step6-gpt-design.js";
 export * from "./conversion-hints.js";
 export * from "./industry-classification.js";
 export * from "./business-facts.js";
@@ -1925,6 +1927,7 @@ export declare const AgentRunTypeSchema: z.ZodEnum<{
     workspace: "workspace";
 }>;
 export declare const AgentRunKindSchema: z.ZodEnum<{
+    landing_page: "landing_page";
     sitemap: "sitemap";
     clarify: "clarify";
     initial_generation: "initial_generation";
@@ -1949,6 +1952,7 @@ export declare const AgentRunRecordSchema: z.ZodObject<{
         workspace: "workspace";
     }>;
     run_kind: z.ZodEnum<{
+        landing_page: "landing_page";
         sitemap: "sitemap";
         clarify: "clarify";
         initial_generation: "initial_generation";
@@ -1971,8 +1975,119 @@ export declare const AgentRunRecordSchema: z.ZodObject<{
     finished_at: z.ZodNullable<z.ZodString>;
     error_code: z.ZodNullable<z.ZodString>;
     created_at: z.ZodString;
+    thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
 }, z.core.$strip>;
 export type AgentRunRecord = z.infer<typeof AgentRunRecordSchema>;
+/**
+ * 线程类别：`workspace` = 用户在站点工作台开的会话（NULL 线程是默认会话）；
+ * `landing_page` = 一个落地页一条；`external` = 外部编排系统的会话。
+ */
+export declare const AgentThreadKindSchema: z.ZodEnum<{
+    landing_page: "landing_page";
+    external: "external";
+    workspace: "workspace";
+}>;
+export type AgentThreadKind = z.infer<typeof AgentThreadKindSchema>;
+/** 线程来源：`user` = 浏览器里的人发起；`background` = 后台（内网 API / 无人值守）发起。 */
+export declare const AgentThreadOriginSchema: z.ZodEnum<{
+    background: "background";
+    user: "user";
+}>;
+export type AgentThreadOrigin = z.infer<typeof AgentThreadOriginSchema>;
+export declare const AgentThreadStatusSchema: z.ZodEnum<{
+    active: "active";
+    archived: "archived";
+}>;
+export type AgentThreadStatus = z.infer<typeof AgentThreadStatusSchema>;
+export declare const AgentThreadRecordSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    tenant_id: z.ZodString;
+    site_id: z.ZodUUID;
+    kind: z.ZodEnum<{
+        landing_page: "landing_page";
+        external: "external";
+        workspace: "workspace";
+    }>;
+    origin: z.ZodEnum<{
+        background: "background";
+        user: "user";
+    }>;
+    subject_key: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        archived: "archived";
+    }>;
+    external_thread_id: z.ZodNullable<z.ZodString>;
+    last_run_id: z.ZodNullable<z.ZodUUID>;
+    last_activity_at: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+export type AgentThreadRecord = z.infer<typeof AgentThreadRecordSchema>;
+export declare const AgentRunContextResponseSchema: z.ZodObject<{
+    agent_run: z.ZodObject<{
+        id: z.ZodUUID;
+        tenant_id: z.ZodString;
+        site_id: z.ZodUUID;
+        agent_type: z.ZodEnum<{
+            sitemap: "sitemap";
+            clarify: "clarify";
+            workspace: "workspace";
+        }>;
+        run_kind: z.ZodEnum<{
+            landing_page: "landing_page";
+            sitemap: "sitemap";
+            clarify: "clarify";
+            initial_generation: "initial_generation";
+            iteration: "iteration";
+        }>;
+        status: z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+            running: "running";
+            queued: "queued";
+            cancelled: "cancelled";
+        }>;
+        model_route: z.ZodEnum<{
+            sitemap: "sitemap";
+            clarify: "clarify";
+            workspace: "workspace";
+            summarize: "summarize";
+        }>;
+        started_at: z.ZodNullable<z.ZodString>;
+        finished_at: z.ZodNullable<z.ZodString>;
+        error_code: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodString;
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    }, z.core.$strip>;
+    thread: z.ZodNullable<z.ZodObject<{
+        id: z.ZodUUID;
+        tenant_id: z.ZodString;
+        site_id: z.ZodUUID;
+        kind: z.ZodEnum<{
+            landing_page: "landing_page";
+            external: "external";
+            workspace: "workspace";
+        }>;
+        origin: z.ZodEnum<{
+            background: "background";
+            user: "user";
+        }>;
+        subject_key: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodEnum<{
+            active: "active";
+            archived: "archived";
+        }>;
+        external_thread_id: z.ZodNullable<z.ZodString>;
+        last_run_id: z.ZodNullable<z.ZodUUID>;
+        last_activity_at: z.ZodString;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AgentRunContextResponse = z.infer<typeof AgentRunContextResponseSchema>;
 export type AgentModelRoute = z.infer<typeof AgentModelRouteSchema>;
 export declare const CreateAgentRunRequestSchema: z.ZodObject<{
     run_id: z.ZodOptional<z.ZodUUID>;
@@ -1983,6 +2098,7 @@ export declare const CreateAgentRunRequestSchema: z.ZodObject<{
         workspace: "workspace";
     }>;
     run_kind: z.ZodOptional<z.ZodEnum<{
+        landing_page: "landing_page";
         sitemap: "sitemap";
         clarify: "clarify";
         initial_generation: "initial_generation";
@@ -2008,6 +2124,7 @@ export declare const CreateAgentRunResponseSchema: z.ZodObject<{
             workspace: "workspace";
         }>;
         run_kind: z.ZodEnum<{
+            landing_page: "landing_page";
             sitemap: "sitemap";
             clarify: "clarify";
             initial_generation: "initial_generation";
@@ -2030,6 +2147,7 @@ export declare const CreateAgentRunResponseSchema: z.ZodObject<{
         finished_at: z.ZodNullable<z.ZodString>;
         error_code: z.ZodNullable<z.ZodString>;
         created_at: z.ZodString;
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     }, z.core.$strip>;
     next_step: z.ZodLiteral<"stream_events">;
 }, z.core.$strip>;
@@ -4146,6 +4264,7 @@ export declare const CreateAgentRunConflictResponseSchema: z.ZodObject<{
                     workspace: "workspace";
                 }>;
                 run_kind: z.ZodEnum<{
+                    landing_page: "landing_page";
                     sitemap: "sitemap";
                     clarify: "clarify";
                     initial_generation: "initial_generation";
@@ -4168,6 +4287,7 @@ export declare const CreateAgentRunConflictResponseSchema: z.ZodObject<{
                 finished_at: z.ZodNullable<z.ZodString>;
                 error_code: z.ZodNullable<z.ZodString>;
                 created_at: z.ZodString;
+                thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
             }, z.core.$strip>;
         }, z.core.$strip>;
     }, z.core.$strip>;
@@ -11437,6 +11557,7 @@ export declare const PersistSiteDesignPlanResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type PersistSiteDesignPlanResponse = z.infer<typeof PersistSiteDesignPlanResponseSchema>;
 export declare const WorkspaceRunKindSchema: z.ZodEnum<{
+    landing_page: "landing_page";
     initial_generation: "initial_generation";
     iteration: "iteration";
 }>;
@@ -11686,6 +11807,7 @@ export type WorkspacePlanDependency = z.infer<typeof WorkspacePlanDependencySche
 export declare const WorkspaceExecutionPlanSchema: z.ZodObject<{
     plan_id: z.ZodString;
     run_kind: z.ZodEnum<{
+        landing_page: "landing_page";
         initial_generation: "initial_generation";
         iteration: "iteration";
     }>;
@@ -12370,6 +12492,7 @@ export declare const AgentEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"workspace.plan.created">;
     plan_id: z.ZodString;
     run_kind: z.ZodEnum<{
+        landing_page: "landing_page";
         initial_generation: "initial_generation";
         iteration: "iteration";
     }>;
@@ -13244,6 +13367,7 @@ export declare const AgentEventRecordSchema: z.ZodObject<{
         type: z.ZodLiteral<"workspace.plan.created">;
         plan_id: z.ZodString;
         run_kind: z.ZodEnum<{
+            landing_page: "landing_page";
             initial_generation: "initial_generation";
             iteration: "iteration";
         }>;
@@ -13630,6 +13754,7 @@ export declare const AgentEventRecordSchema: z.ZodObject<{
         at: z.ZodString;
     }, z.core.$strip>], "type">;
     created_at: z.ZodString;
+    thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
 }, z.core.$strip>;
 export type AgentEventRecord = z.infer<typeof AgentEventRecordSchema>;
 export declare const AppendAgentEventRequestSchema: z.ZodObject<{
@@ -14115,6 +14240,7 @@ export declare const AppendAgentEventRequestSchema: z.ZodObject<{
         type: z.ZodLiteral<"workspace.plan.created">;
         plan_id: z.ZodString;
         run_kind: z.ZodEnum<{
+            landing_page: "landing_page";
             initial_generation: "initial_generation";
             iteration: "iteration";
         }>;
@@ -14514,6 +14640,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
             workspace: "workspace";
         }>;
         run_kind: z.ZodEnum<{
+            landing_page: "landing_page";
             sitemap: "sitemap";
             clarify: "clarify";
             initial_generation: "initial_generation";
@@ -14536,6 +14663,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
         finished_at: z.ZodNullable<z.ZodString>;
         error_code: z.ZodNullable<z.ZodString>;
         created_at: z.ZodString;
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     }, z.core.$strip>;
     event: z.ZodObject<{
         id: z.ZodUUID;
@@ -15025,6 +15153,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
             type: z.ZodLiteral<"workspace.plan.created">;
             plan_id: z.ZodString;
             run_kind: z.ZodEnum<{
+                landing_page: "landing_page";
                 initial_generation: "initial_generation";
                 iteration: "iteration";
             }>;
@@ -15411,6 +15540,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
             at: z.ZodString;
         }, z.core.$strip>], "type">;
         created_at: z.ZodString;
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     }, z.core.$strip>;
     next_cursor: z.ZodNumber;
 }, z.core.$strip>, z.ZodObject<{
@@ -15425,6 +15555,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
             workspace: "workspace";
         }>;
         run_kind: z.ZodEnum<{
+            landing_page: "landing_page";
             sitemap: "sitemap";
             clarify: "clarify";
             initial_generation: "initial_generation";
@@ -15447,6 +15578,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
         finished_at: z.ZodNullable<z.ZodString>;
         error_code: z.ZodNullable<z.ZodString>;
         created_at: z.ZodString;
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     }, z.core.$strip>;
     event: z.ZodObject<{
         id: z.ZodUUID;
@@ -15936,6 +16068,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
             type: z.ZodLiteral<"workspace.plan.created">;
             plan_id: z.ZodString;
             run_kind: z.ZodEnum<{
+                landing_page: "landing_page";
                 initial_generation: "initial_generation";
                 iteration: "iteration";
             }>;
@@ -16322,6 +16455,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
             at: z.ZodString;
         }, z.core.$strip>], "type">;
         created_at: z.ZodString;
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     }, z.core.$strip>;
     next_cursor: z.ZodNumber;
 }, z.core.$strip>], "status">;
@@ -16815,6 +16949,7 @@ export declare const ListAgentEventsResponseSchema: z.ZodObject<{
             type: z.ZodLiteral<"workspace.plan.created">;
             plan_id: z.ZodString;
             run_kind: z.ZodEnum<{
+                landing_page: "landing_page";
                 initial_generation: "initial_generation";
                 iteration: "iteration";
             }>;
@@ -17201,6 +17336,7 @@ export declare const ListAgentEventsResponseSchema: z.ZodObject<{
             at: z.ZodString;
         }, z.core.$strip>], "type">;
         created_at: z.ZodString;
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     }, z.core.$strip>>;
     next_cursor: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -17209,6 +17345,16 @@ export declare const ListAgentEventsQuerySchema: z.ZodObject<{
     after_sequence: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strip>;
 export type ListAgentEventsQuery = z.infer<typeof ListAgentEventsQuerySchema>;
+/**
+ * `GET /sites/:site_id/agent-events` 的查询参数：带 run_id 时按该 run 的线程过滤；
+ * 带 thread_id 时按命名线程过滤（服务端校验归属：同租户、同站点）。
+ * 二者互斥，同时传入判为无效请求。
+ */
+export declare const ListSiteAgentEventsQuerySchema: z.ZodObject<{
+    run_id: z.ZodOptional<z.ZodUUID>;
+    thread_id: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strip>;
+export type ListSiteAgentEventsQuery = z.infer<typeof ListSiteAgentEventsQuerySchema>;
 export declare const ApiContractStatusSchema: z.ZodEnum<{
     implemented: "implemented";
     skeleton: "skeleton";
@@ -17866,6 +18012,40 @@ export declare const REST_API_ENDPOINTS: readonly [{
     readonly request_body_schema: "StartWorkspaceRunRequestSchema";
     readonly response_schema: "StartWorkspaceRunResponseSchema";
     readonly notes: readonly ["Long-running work must be event-driven and must not block API transactions."];
+}, {
+    readonly method: "GET";
+    readonly path: "/sites/:site_id/threads";
+    readonly tag: "workspace";
+    readonly summary: "List a site's named Agent threads (workspace conversations).";
+    readonly status: "implemented";
+    readonly response_schema: "SiteThreadListResponseSchema";
+    readonly notes: readonly ["The browser can only list threads that belong to the current site."];
+}, {
+    readonly method: "POST";
+    readonly path: "/sites/:site_id/threads";
+    readonly tag: "workspace";
+    readonly summary: "Create a new named Agent thread for a site.";
+    readonly status: "implemented";
+    readonly request_body_schema: "CreateSiteThreadRequestSchema";
+    readonly response_schema: "SiteThreadResponseSchema";
+    readonly notes: readonly ["The created thread is scoped to the current site; the browser cannot create a thread for another site."];
+}, {
+    readonly method: "PATCH";
+    readonly path: "/sites/:site_id/threads/:thread_id";
+    readonly tag: "workspace";
+    readonly summary: "Rename or archive an Agent thread.";
+    readonly status: "implemented";
+    readonly request_body_schema: "UpdateSiteThreadRequestSchema";
+    readonly response_schema: "SiteThreadResponseSchema";
+    readonly notes: readonly ["The server verifies the thread belongs to the current site and tenant before applying the update."];
+}, {
+    readonly method: "GET";
+    readonly path: "/sites/:site_id/workspace/runs/active";
+    readonly tag: "workspace";
+    readonly summary: "Look up the site's current in-flight Workspace Agent run across all threads.";
+    readonly status: "implemented";
+    readonly response_schema: "ActiveWorkspaceRunResponseSchema";
+    readonly notes: readonly ["Scoped to the current site regardless of thread; the browser cannot query another site's active run."];
 }, {
     readonly method: "POST";
     readonly path: "/v1/agent/workspace/:site_id/form-design-operations";
@@ -18139,15 +18319,15 @@ export declare const REST_API_ENDPOINTS: readonly [{
     readonly summary: "Start or recover the site publish workflow.";
     readonly status: "implemented";
     readonly request_body_schema: "StartSitePublishWorkflowRequestSchema";
-    readonly response_schema: "SitePublishWorkflowMutationResponseSchema";
+    readonly response_schema: "SitePublishWorkflowQualityResponseSchema";
 }, {
     readonly method: "POST";
-    readonly path: "/sites/:site_id/publish-workflow/:workflow_id/quality-task";
+    readonly path: "/sites/:site_id/publish-workflow/:workflow_id/repair-task";
     readonly tag: "publish-workflow";
-    readonly summary: "Create a new quality task for a failed publish workflow.";
+    readonly summary: "Idempotently create the publish repair task.";
     readonly status: "implemented";
     readonly request_body_schema: "SitePublishWorkflowRevisionRequestSchema";
-    readonly response_schema: "SitePublishWorkflowMutationResponseSchema";
+    readonly response_schema: "SitePublishWorkflowQualityResponseSchema";
 }, {
     readonly method: "GET";
     readonly path: "/sites/:site_id/publish-workflow/:workflow_id";
@@ -18397,6 +18577,7 @@ export declare const StartWorkspaceRunRequestSchema: z.ZodObject<{
         }, z.core.$strip>]>>;
         role: z.ZodLiteral<"user">;
     }, z.core.$strip>>;
+    thread_id: z.ZodOptional<z.ZodUUID>;
     client_run_key: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type StartWorkspaceRunRequest = z.infer<typeof StartWorkspaceRunRequestSchema>;
@@ -18405,6 +18586,7 @@ export declare const WorkspaceSocketDescriptorSchema: z.ZodObject<{
     run_id: z.ZodUUID;
     base_snapshot_id: z.ZodUUID;
     run_kind: z.ZodEnum<{
+        landing_page: "landing_page";
         initial_generation: "initial_generation";
         iteration: "iteration";
     }>;
@@ -18421,6 +18603,7 @@ export declare const StartWorkspaceRunResponseSchema: z.ZodObject<{
             workspace: "workspace";
         }>;
         run_kind: z.ZodEnum<{
+            landing_page: "landing_page";
             sitemap: "sitemap";
             clarify: "clarify";
             initial_generation: "initial_generation";
@@ -18443,12 +18626,14 @@ export declare const StartWorkspaceRunResponseSchema: z.ZodObject<{
         finished_at: z.ZodNullable<z.ZodString>;
         error_code: z.ZodNullable<z.ZodString>;
         created_at: z.ZodString;
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     }, z.core.$strip>;
     websocket: z.ZodObject<{
         path: z.ZodString;
         run_id: z.ZodUUID;
         base_snapshot_id: z.ZodUUID;
         run_kind: z.ZodEnum<{
+            landing_page: "landing_page";
             initial_generation: "initial_generation";
             iteration: "iteration";
         }>;
@@ -18475,6 +18660,7 @@ export declare const LatestWorkspaceRunResponseSchema: z.ZodObject<{
             workspace: "workspace";
         }>;
         run_kind: z.ZodEnum<{
+            landing_page: "landing_page";
             sitemap: "sitemap";
             clarify: "clarify";
             initial_generation: "initial_generation";
@@ -18497,9 +18683,151 @@ export declare const LatestWorkspaceRunResponseSchema: z.ZodObject<{
         finished_at: z.ZodNullable<z.ZodString>;
         error_code: z.ZodNullable<z.ZodString>;
         created_at: z.ZodString;
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type LatestWorkspaceRunResponse = z.infer<typeof LatestWorkspaceRunResponseSchema>;
+export declare const LatestWorkspaceRunQuerySchema: z.ZodObject<{
+    thread_id: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strip>;
+export type LatestWorkspaceRunQuery = z.infer<typeof LatestWorkspaceRunQuerySchema>;
+/** `GET /sites/:site_id/workspace/runs/active`：站点当前在途 workspace run（不分线程）。 */
+export declare const ActiveWorkspaceRunResponseSchema: z.ZodObject<{
+    agent_run: z.ZodNullable<z.ZodObject<{
+        id: z.ZodUUID;
+        tenant_id: z.ZodString;
+        site_id: z.ZodUUID;
+        agent_type: z.ZodEnum<{
+            sitemap: "sitemap";
+            clarify: "clarify";
+            workspace: "workspace";
+        }>;
+        run_kind: z.ZodEnum<{
+            landing_page: "landing_page";
+            sitemap: "sitemap";
+            clarify: "clarify";
+            initial_generation: "initial_generation";
+            iteration: "iteration";
+        }>;
+        status: z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+            running: "running";
+            queued: "queued";
+            cancelled: "cancelled";
+        }>;
+        model_route: z.ZodEnum<{
+            sitemap: "sitemap";
+            clarify: "clarify";
+            workspace: "workspace";
+            summarize: "summarize";
+        }>;
+        started_at: z.ZodNullable<z.ZodString>;
+        finished_at: z.ZodNullable<z.ZodString>;
+        error_code: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodString;
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    }, z.core.$strip>>;
+    thread: z.ZodNullable<z.ZodObject<{
+        id: z.ZodUUID;
+        tenant_id: z.ZodString;
+        site_id: z.ZodUUID;
+        kind: z.ZodEnum<{
+            landing_page: "landing_page";
+            external: "external";
+            workspace: "workspace";
+        }>;
+        origin: z.ZodEnum<{
+            background: "background";
+            user: "user";
+        }>;
+        subject_key: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodEnum<{
+            active: "active";
+            archived: "archived";
+        }>;
+        external_thread_id: z.ZodNullable<z.ZodString>;
+        last_run_id: z.ZodNullable<z.ZodUUID>;
+        last_activity_at: z.ZodString;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ActiveWorkspaceRunResponse = z.infer<typeof ActiveWorkspaceRunResponseSchema>;
+/** `/sites/:site_id/threads` 线程端点合同。 */
+export declare const SiteThreadListQuerySchema: z.ZodObject<{
+    status: z.ZodDefault<z.ZodEnum<{
+        active: "active";
+        archived: "archived";
+    }>>;
+}, z.core.$strip>;
+export type SiteThreadListQuery = z.infer<typeof SiteThreadListQuerySchema>;
+export declare const SiteThreadListResponseSchema: z.ZodObject<{
+    threads: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        tenant_id: z.ZodString;
+        site_id: z.ZodUUID;
+        kind: z.ZodEnum<{
+            landing_page: "landing_page";
+            external: "external";
+            workspace: "workspace";
+        }>;
+        origin: z.ZodEnum<{
+            background: "background";
+            user: "user";
+        }>;
+        subject_key: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodEnum<{
+            active: "active";
+            archived: "archived";
+        }>;
+        external_thread_id: z.ZodNullable<z.ZodString>;
+        last_run_id: z.ZodNullable<z.ZodUUID>;
+        last_activity_at: z.ZodString;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SiteThreadListResponse = z.infer<typeof SiteThreadListResponseSchema>;
+export declare const CreateSiteThreadRequestSchema: z.ZodObject<{
+    title: z.ZodString;
+}, z.core.$strict>;
+export type CreateSiteThreadRequest = z.infer<typeof CreateSiteThreadRequestSchema>;
+export declare const UpdateSiteThreadRequestSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodLiteral<"archived">>;
+}, z.core.$strict>;
+export type UpdateSiteThreadRequest = z.infer<typeof UpdateSiteThreadRequestSchema>;
+export declare const SiteThreadResponseSchema: z.ZodObject<{
+    thread: z.ZodObject<{
+        id: z.ZodUUID;
+        tenant_id: z.ZodString;
+        site_id: z.ZodUUID;
+        kind: z.ZodEnum<{
+            landing_page: "landing_page";
+            external: "external";
+            workspace: "workspace";
+        }>;
+        origin: z.ZodEnum<{
+            background: "background";
+            user: "user";
+        }>;
+        subject_key: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodEnum<{
+            active: "active";
+            archived: "archived";
+        }>;
+        external_thread_id: z.ZodNullable<z.ZodString>;
+        last_run_id: z.ZodNullable<z.ZodUUID>;
+        last_activity_at: z.ZodString;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SiteThreadResponse = z.infer<typeof SiteThreadResponseSchema>;
 /**
  * `GET /sites/:site_id/agent-runs/latest?agent_type=clarify|sitemap|workspace`
  *
@@ -18512,6 +18840,7 @@ export declare const LatestAgentRunQuerySchema: z.ZodObject<{
         clarify: "clarify";
         workspace: "workspace";
     }>;
+    thread_id: z.ZodOptional<z.ZodUUID>;
 }, z.core.$strip>;
 export declare const LatestAgentRunResponseSchema: z.ZodObject<{
     agent_run: z.ZodObject<{
@@ -18524,6 +18853,7 @@ export declare const LatestAgentRunResponseSchema: z.ZodObject<{
             workspace: "workspace";
         }>;
         run_kind: z.ZodEnum<{
+            landing_page: "landing_page";
             sitemap: "sitemap";
             clarify: "clarify";
             initial_generation: "initial_generation";
@@ -18546,6 +18876,7 @@ export declare const LatestAgentRunResponseSchema: z.ZodObject<{
         finished_at: z.ZodNullable<z.ZodString>;
         error_code: z.ZodNullable<z.ZodString>;
         created_at: z.ZodString;
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type LatestAgentRunQuery = z.infer<typeof LatestAgentRunQuerySchema>;
@@ -19380,6 +19711,7 @@ export declare const WorkspaceServerMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
     payload: z.ZodObject<{
         plan_id: z.ZodString;
         run_kind: z.ZodEnum<{
+            landing_page: "landing_page";
             initial_generation: "initial_generation";
             iteration: "iteration";
         }>;
@@ -20578,6 +20910,7 @@ export declare const WorkspaceWebSocketMessageSchema: z.ZodUnion<readonly [z.Zod
     payload: z.ZodObject<{
         plan_id: z.ZodString;
         run_kind: z.ZodEnum<{
+            landing_page: "landing_page";
             initial_generation: "initial_generation";
             iteration: "iteration";
         }>;
@@ -21597,6 +21930,7 @@ export declare const CancelActiveWorkspaceRunResponseSchema: z.ZodObject<{
             workspace: "workspace";
         }>;
         run_kind: z.ZodEnum<{
+            landing_page: "landing_page";
             sitemap: "sitemap";
             clarify: "clarify";
             initial_generation: "initial_generation";
@@ -21619,6 +21953,7 @@ export declare const CancelActiveWorkspaceRunResponseSchema: z.ZodObject<{
         finished_at: z.ZodNullable<z.ZodString>;
         error_code: z.ZodNullable<z.ZodString>;
         created_at: z.ZodString;
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type CancelActiveWorkspaceRunResponse = z.infer<typeof CancelActiveWorkspaceRunResponseSchema>;
@@ -21626,7 +21961,7 @@ export { DEFAULT_FONTS, FONT_PAIRINGS, fontStack, NEXT_FONT_DISPLAY_NAMES, NEXT_
 export type { FontPairing, NextFontEntry } from "./font-catalog.js";
 export { THEME_PRESETS } from "./theme-presets.js";
 export type { ThemePreset } from "./theme-presets.js";
-export { MEDIA_LIBRARY_AUDIO_EXTENSIONS, MEDIA_LIBRARY_DOCUMENT_EXTENSIONS, MEDIA_LIBRARY_EXTENSIONS, MEDIA_LIBRARY_FILE_EXTENSIONS, MEDIA_LIBRARY_IMAGE_EXTENSIONS, MEDIA_LIBRARY_IMAGE_MAX_BYTES, MEDIA_LIBRARY_IMAGE_MIME_TYPES, MEDIA_LIBRARY_MAX_BYTES, MEDIA_LIBRARY_VIDEO_MIME_TYPES, MEDIA_LIBRARY_VIDEO_EXTENSIONS, MEDIA_LIBRARY_AUDIO_MIME_TYPES, MEDIA_LIBRARY_MIME_TYPES, MediaLibraryFileTypeSchema, MediaLibrarySourceSchema, MediaLibraryAssetSchema, ListMediaLibraryAssetsQuerySchema, ListMediaLibraryAssetsResponseSchema, UploadMediaLibraryAssetResponseSchema, UnsplashMediaAssetSchema, SearchUnsplashMediaQuerySchema, SearchUnsplashMediaResponseSchema, UnsplashDownloadLocationSchema, UseUnsplashMediaRequestSchema, UseUnsplashMediaResponseSchema, RegisterMediaResourceReferenceRequestSchema, RegisterMediaResourceReferenceResponseSchema, } from "./media-library.js";
-export type { MediaLibraryFileType, MediaLibrarySource, MediaLibraryAsset, ListMediaLibraryAssetsQuery, ListMediaLibraryAssetsResponse, UploadMediaLibraryAssetResponse, UnsplashMediaAsset, SearchUnsplashMediaQuery, SearchUnsplashMediaResponse, UseUnsplashMediaRequest, UseUnsplashMediaResponse, RegisterMediaResourceReferenceRequest, RegisterMediaResourceReferenceResponse, } from "./media-library.js";
+export { MEDIA_LIBRARY_AUDIO_EXTENSIONS, MEDIA_LIBRARY_DOCUMENT_EXTENSIONS, MEDIA_LIBRARY_EXTENSIONS, MEDIA_LIBRARY_FILE_EXTENSIONS, MEDIA_LIBRARY_IMAGE_EXTENSIONS, MEDIA_LIBRARY_IMAGE_MAX_BYTES, MEDIA_LIBRARY_IMAGE_MIME_TYPES, MEDIA_LIBRARY_MAX_BYTES, MEDIA_LIBRARY_VIDEO_MIME_TYPES, MEDIA_LIBRARY_VIDEO_EXTENSIONS, MEDIA_LIBRARY_AUDIO_MIME_TYPES, MEDIA_LIBRARY_MIME_TYPES, MediaLibraryFileTypeSchema, MediaLibrarySourceSchema, MediaLibraryAssetSchema, ListMediaLibraryAssetsQuerySchema, ListMediaLibraryAssetsResponseSchema, UploadMediaLibraryAssetResponseSchema, AI_IMAGE_GENERATION_MAX_QUANTITY, AI_IMAGE_GENERATION_ENTITLEMENT, AiImageGenerationPrecheckRequestSchema, AiImageGenerationQuotaSchema, AiImageGenerationPrecheckResponseSchema, GenerateAiImagesRequestSchema, GeneratedAiImageResultSchema, GenerateAiImagesResponseSchema, UnsplashMediaAssetSchema, SearchUnsplashMediaQuerySchema, SearchUnsplashMediaResponseSchema, UnsplashDownloadLocationSchema, UseUnsplashMediaRequestSchema, UseUnsplashMediaResponseSchema, RegisterMediaResourceReferenceRequestSchema, RegisterMediaResourceReferenceResponseSchema, } from "./media-library.js";
+export type { MediaLibraryFileType, MediaLibrarySource, MediaLibraryAsset, ListMediaLibraryAssetsQuery, ListMediaLibraryAssetsResponse, UploadMediaLibraryAssetResponse, AiImageGenerationPrecheckRequest, AiImageGenerationQuota, AiImageGenerationPrecheckResponse, GenerateAiImagesRequest, GeneratedAiImageResult, GenerateAiImagesResponse, UnsplashMediaAsset, SearchUnsplashMediaQuery, SearchUnsplashMediaResponse, UseUnsplashMediaRequest, UseUnsplashMediaResponse, RegisterMediaResourceReferenceRequest, RegisterMediaResourceReferenceResponse, } from "./media-library.js";
 export { WorkspaceDesignApplyRequestSchema, WorkspaceDesignApplyResponseSchema, } from "./workspace-design-apply.js";
 export type { WorkspaceDesignApplyRequest, WorkspaceDesignApplyResponse, } from "./workspace-design-apply.js";