@vcp-dev/contracts 0.9.4 → 0.9.6

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

@@ -64,6 +64,7 @@ export declare const CreateExternalSiteEditRequestSchema: z.ZodObject<{
     external_run_id: z.ZodString;
     external_thread_id: z.ZodString;
     prompt: z.ZodString;
+    thread_title: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type CreateExternalSiteEditRequest = z.infer<typeof CreateExternalSiteEditRequestSchema>;
 /**
@@ -104,6 +105,7 @@ export declare const ExternalSiteEditTaskSchema: z.ZodObject<{
         sandbox_unavailable: "sandbox_unavailable";
     }>>;
     vcp_run_id: z.ZodNullable<z.ZodUUID>;
+    vcp_thread_id: z.ZodNullable<z.ZodUUID>;
     base_snapshot_id: z.ZodUUID;
     snapshot_id: z.ZodNullable<z.ZodUUID>;
     preview_url: z.ZodNullable<z.ZodString>;
@@ -153,6 +155,7 @@ export declare const CreateExternalSiteEditResponseSchema: z.ZodObject<{
             sandbox_unavailable: "sandbox_unavailable";
         }>>;
         vcp_run_id: z.ZodNullable<z.ZodUUID>;
+        vcp_thread_id: z.ZodNullable<z.ZodUUID>;
         base_snapshot_id: z.ZodUUID;
         snapshot_id: z.ZodNullable<z.ZodUUID>;
         preview_url: z.ZodNullable<z.ZodString>;
@@ -203,6 +206,7 @@ export declare const GetExternalSiteEditResponseSchema: z.ZodObject<{
             sandbox_unavailable: "sandbox_unavailable";
         }>>;
         vcp_run_id: z.ZodNullable<z.ZodUUID>;
+        vcp_thread_id: z.ZodNullable<z.ZodUUID>;
         base_snapshot_id: z.ZodUUID;
         snapshot_id: z.ZodNullable<z.ZodUUID>;
         preview_url: z.ZodNullable<z.ZodString>;

package/dist/index.d.ts

@@ -55,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";
@@ -1926,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";
@@ -1950,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";
@@ -1972,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>;
@@ -1984,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";
@@ -2009,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";
@@ -2031,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>;
@@ -4147,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";
@@ -4169,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>;
@@ -11438,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";
 }>;
@@ -11687,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";
     }>;
@@ -12371,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";
     }>;
@@ -13245,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";
         }>;
@@ -13631,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<{
@@ -14116,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";
         }>;
@@ -14515,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";
@@ -14537,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;
@@ -15026,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";
             }>;
@@ -15412,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<{
@@ -15426,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";
@@ -15448,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;
@@ -15937,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";
             }>;
@@ -16323,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">;
@@ -16816,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";
             }>;
@@ -17202,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>;
@@ -17210,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";
@@ -17867,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";
@@ -18398,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>;
@@ -18406,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";
     }>;
@@ -18422,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";
@@ -18444,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";
         }>;
@@ -18476,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";
@@ -18498,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`
  *
@@ -18513,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<{
@@ -18525,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";
@@ -18547,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>;
@@ -19381,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";
         }>;
@@ -20579,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";
         }>;
@@ -21598,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";
@@ -21620,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>;