@gestaltrun/dsh-workspace-bundle 0.1.0 → 0.1.1

package/lib/types/agent-config-contract/cs-hosting.d.ts

@@ -0,0 +1,1333 @@
+/** 客服托管权、租约与运行状态检查点契约。子账号归属使用本服务 UserId。 @module */
+import { z } from 'zod';
+/** 旺旺账号的稳定、不透明标识；不作昵称或大小写归一化。 */
+export declare const WangwangAccountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+export type WangwangAccountId = z.infer<typeof WangwangAccountId>;
+/** 本机安装标识，由 Host 产生并持久保存。 */
+export declare const InstallationId: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+export type InstallationId = z.infer<typeof InstallationId>;
+/** 云端沙箱标识，不限定执行器的标识格式。 */
+export declare const SandboxId: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+export type SandboxId = z.infer<typeof SandboxId>;
+/** 持有者种类参与匹配，相同文本的安装与沙箱不是同一持有者。 */
+export declare const HostingHolder: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"installation">;
+    id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"sandbox">;
+    id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+}, z.core.$strip>], "kind">;
+export type HostingHolder = z.infer<typeof HostingHolder>;
+/** 单调递增的 CAS 代次，JSON 安全整数。 */
+export declare const HostingEpoch: z.ZodNumber;
+export declare const HostingLeaseParams: z.ZodObject<{
+    tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+    userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+    accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+}, z.core.$strip>;
+/** 禁止通过查询串指定身份或客户端时间。 */
+export declare const HostingLeaseQuery: z.ZodObject<{}, z.core.$strict>;
+/** 未开通不保存记录，调用方按本地既有行为继续运行。 */
+export declare const HostingNotEnabled: z.ZodObject<{
+    cloudEnabled: z.ZodLiteral<false>;
+    serverTime: z.ZodISODateTime;
+}, z.core.$strip>;
+/** 有效性以 serverTime 为准；到期记录保留持有者与 epoch 供 CAS 接管。 */
+export declare const HostingEnabled: z.ZodObject<{
+    cloudEnabled: z.ZodLiteral<true>;
+    holder: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"installation">;
+        id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"sandbox">;
+        id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+    }, z.core.$strip>], "kind">>;
+    epoch: z.ZodNumber;
+    state: z.ZodEnum<{
+        unheld: "unheld";
+        active: "active";
+        expired: "expired";
+    }>;
+    leaseExpiresAt: z.ZodNullable<z.ZodISODateTime>;
+    remainingSeconds: z.ZodNumber;
+    serverTime: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export declare const HostingLeaseResponse: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    cloudEnabled: z.ZodLiteral<false>;
+    serverTime: z.ZodISODateTime;
+}, z.core.$strip>, z.ZodObject<{
+    cloudEnabled: z.ZodLiteral<true>;
+    holder: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"installation">;
+        id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"sandbox">;
+        id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+    }, z.core.$strip>], "kind">>;
+    epoch: z.ZodNumber;
+    state: z.ZodEnum<{
+        unheld: "unheld";
+        active: "active";
+        expired: "expired";
+    }>;
+    leaseExpiresAt: z.ZodNullable<z.ZodISODateTime>;
+    remainingSeconds: z.ZodNumber;
+    serverTime: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strip>], "cloudEnabled">;
+export type HostingLeaseResponse = z.infer<typeof HostingLeaseResponse>;
+/** 取得只允许无持有者或已到期；expectedEpoch 必须匹配，成功后加一。 */
+export declare const AcquireHostingLeaseRequest: z.ZodObject<{
+    holder: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"installation">;
+        id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"sandbox">;
+        id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+    }, z.core.$strip>], "kind">;
+    expectedEpoch: z.ZodNumber;
+}, z.core.$strict>;
+/** 云端首次开通只接受当前沙箱；不携带 epoch，也不接受本机安装。 */
+export declare const FirstEnableHostingLeaseRequest: z.ZodObject<{
+    holder: z.ZodObject<{
+        kind: z.ZodLiteral<"sandbox">;
+        id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+/** 续约和释放验证完整持有者与当前 epoch；过期续约拒绝。 */
+export declare const HostingLeaseOwnerRequest: z.ZodObject<{
+    holder: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"installation">;
+        id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"sandbox">;
+        id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+    }, z.core.$strip>], "kind">;
+    epoch: z.ZodNumber;
+}, z.core.$strict>;
+/** 交接要求源租约有效；目标获得新 epoch 与完整 TTL。 */
+export declare const HandoffHostingLeaseRequest: z.ZodObject<{
+    holder: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"installation">;
+        id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"sandbox">;
+        id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+    }, z.core.$strip>], "kind">;
+    epoch: z.ZodNumber;
+    target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"installation">;
+        id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"sandbox">;
+        id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strict>;
+/** 只能查询当前店铺租户中本人的旺旺账号托管权。本账号无记录但同一用户已有 active 持有者时返回该持有者。 */
+export declare const getHostingLease: {
+    readonly method: "get";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/lease";
+    readonly summary: "查询本人托管权";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "托管权状态。本账号没有记录但同一用户在其他旺旺账号上已有未过期的 active 持有者时，返回该持有者且 cloudEnabled=true。本账号已有未开通记录，或没有其他 active 持有者时，返回 cloudEnabled=false，不创建记录";
+            readonly schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<false>;
+                serverTime: z.ZodISODateTime;
+            }, z.core.$strip>, z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<true>;
+                holder: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                    id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"sandbox">;
+                    id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+                }, z.core.$strip>], "kind">>;
+                epoch: z.ZodNumber;
+                state: z.ZodEnum<{
+                    unheld: "unheld";
+                    active: "active";
+                    expired: "expired";
+                }>;
+                leaseExpiresAt: z.ZodNullable<z.ZodISODateTime>;
+                remainingSeconds: z.ZodNumber;
+                serverTime: z.ZodISODateTime;
+                updatedAt: z.ZodISODateTime;
+            }, z.core.$strip>], "cloudEnabled">;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "租约状态不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 503: readonly ["SERVICE_UNAVAILABLE"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH"];
+        readonly 409: readonly ["TENANT_NOT_CURRENT", "HOSTING_EPOCH_MISMATCH", "HOSTING_HELD", "HOSTING_HOLDER_MISMATCH", "HOSTING_LEASE_EXPIRED"];
+    };
+};
+/** 同一用户在其他旺旺账号上已有 active 持有者时回答 HOSTING_HELD，不创建记录。本账号未开通且没有其他 active 持有者时仍返回 cloudEnabled=false。 */
+export declare const acquireHostingLease: {
+    readonly method: "post";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/lease/acquire";
+    readonly summary: "CAS 取得托管租约";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+        readonly body: z.ZodObject<{
+            holder: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+                id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"sandbox">;
+                id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+            }, z.core.$strip>], "kind">;
+            expectedEpoch: z.ZodNumber;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "托管权状态。同一用户在其他旺旺账号上已有 active 持有者时回答 HOSTING_HELD，不创建记录。本账号未开通且没有其他 active 持有者时返回 cloudEnabled=false，不创建记录";
+            readonly schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<false>;
+                serverTime: z.ZodISODateTime;
+            }, z.core.$strip>, z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<true>;
+                holder: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                    id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"sandbox">;
+                    id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+                }, z.core.$strip>], "kind">>;
+                epoch: z.ZodNumber;
+                state: z.ZodEnum<{
+                    unheld: "unheld";
+                    active: "active";
+                    expired: "expired";
+                }>;
+                leaseExpiresAt: z.ZodNullable<z.ZodISODateTime>;
+                remainingSeconds: z.ZodNumber;
+                serverTime: z.ZodISODateTime;
+                updatedAt: z.ZodISODateTime;
+            }, z.core.$strip>], "cloudEnabled">;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "租约状态不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 409: readonly ["TENANT_NOT_CURRENT", "HOSTING_EPOCH_MISMATCH", "HOSTING_HELD", "HOSTING_HOLDER_MISMATCH", "HOSTING_LEASE_EXPIRED", "LOCAL_HOST_REPLACED"];
+        readonly 503: readonly ["SERVICE_UNAVAILABLE"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH"];
+    };
+};
+/** 没有租约记录时创建 cloudEnabled 的沙箱租约；已有记录拒绝，不抢占。同一用户在其他旺旺账号上已有 active 持有者时回答 HOSTING_HELD，不插入。 */
+export declare const firstEnableHostingLease: {
+    readonly method: "post";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/lease/first-enable";
+    readonly summary: "云端沙箱首次开通本人托管权";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+        readonly body: z.ZodObject<{
+            holder: z.ZodObject<{
+                kind: z.ZodLiteral<"sandbox">;
+                id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "已开通的托管权。没有租约记录且同一用户没有其他 active 持有者时创建沙箱持有的 active 租约；同一沙箱重复调用不改变 epoch、持有者或到期时间";
+            readonly schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<false>;
+                serverTime: z.ZodISODateTime;
+            }, z.core.$strip>, z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<true>;
+                holder: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                    id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"sandbox">;
+                    id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+                }, z.core.$strip>], "kind">>;
+                epoch: z.ZodNumber;
+                state: z.ZodEnum<{
+                    unheld: "unheld";
+                    active: "active";
+                    expired: "expired";
+                }>;
+                leaseExpiresAt: z.ZodNullable<z.ZodISODateTime>;
+                remainingSeconds: z.ZodNumber;
+                serverTime: z.ZodISODateTime;
+                updatedAt: z.ZodISODateTime;
+            }, z.core.$strip>], "cloudEnabled">;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "租约状态不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH", "CLOUD_NOT_ELIGIBLE", "SANDBOX_SESSION_UNBOUND"];
+        readonly 503: readonly ["SERVICE_UNAVAILABLE"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+        readonly 409: readonly ["TENANT_NOT_CURRENT", "HOSTING_EPOCH_MISMATCH", "HOSTING_HELD", "HOSTING_HOLDER_MISMATCH", "HOSTING_LEASE_EXPIRED"];
+    };
+};
+/** 已交接或首次开通给沙箱的同一 epoch，在采用及续约时重新确认旧实例退出，成功保持该 epoch。没有租约行，或未完成与锁内判断一致的前任观察时，沙箱续约拒绝且不更新。 */
+export declare const renewHostingLease: {
+    readonly method: "post";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/lease/renew";
+    readonly summary: "续约本人托管权";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+        readonly body: z.ZodObject<{
+            holder: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+                id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"sandbox">;
+                id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+            }, z.core.$strip>], "kind">;
+            epoch: z.ZodNumber;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "已续约的托管权。本机持有者未开通时返回 cloudEnabled=false 且不创建记录；沙箱持有者没有租约行，或前任观察与锁内判断不一致时不刷新租约";
+            readonly schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<false>;
+                serverTime: z.ZodISODateTime;
+            }, z.core.$strip>, z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<true>;
+                holder: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                    id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"sandbox">;
+                    id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+                }, z.core.$strip>], "kind">>;
+                epoch: z.ZodNumber;
+                state: z.ZodEnum<{
+                    unheld: "unheld";
+                    active: "active";
+                    expired: "expired";
+                }>;
+                leaseExpiresAt: z.ZodNullable<z.ZodISODateTime>;
+                remainingSeconds: z.ZodNumber;
+                serverTime: z.ZodISODateTime;
+                updatedAt: z.ZodISODateTime;
+            }, z.core.$strip>], "cloudEnabled">;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "租约状态不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH", "SANDBOX_SESSION_UNBOUND"];
+        readonly 409: readonly ["TENANT_NOT_CURRENT", "HOSTING_EPOCH_MISMATCH", "HOSTING_HELD", "HOSTING_HOLDER_MISMATCH", "HOSTING_LEASE_EXPIRED", "LOCAL_HOST_REPLACED", "PLACEMENT_KEY_NOT_READY", "PREDECESSOR_STILL_RUNNING"];
+        readonly 503: readonly ["SERVICE_UNAVAILABLE", "PREDECESSOR_EXIT_UNKNOWN"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+    };
+};
+/** 释放推进 epoch 并清空持有者；到期的当前持有者也可释放。 */
+export declare const releaseHostingLease: {
+    readonly method: "post";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/lease/release";
+    readonly summary: "释放本人托管权";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+        readonly body: z.ZodObject<{
+            holder: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+                id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"sandbox">;
+                id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+            }, z.core.$strip>], "kind">;
+            epoch: z.ZodNumber;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "托管权状态；未开通的操作同样返回 cloudEnabled=false，不创建记录";
+            readonly schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<false>;
+                serverTime: z.ZodISODateTime;
+            }, z.core.$strip>, z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<true>;
+                holder: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                    id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"sandbox">;
+                    id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+                }, z.core.$strip>], "kind">>;
+                epoch: z.ZodNumber;
+                state: z.ZodEnum<{
+                    unheld: "unheld";
+                    active: "active";
+                    expired: "expired";
+                }>;
+                leaseExpiresAt: z.ZodNullable<z.ZodISODateTime>;
+                remainingSeconds: z.ZodNumber;
+                serverTime: z.ZodISODateTime;
+                updatedAt: z.ZodISODateTime;
+            }, z.core.$strip>], "cloudEnabled">;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "租约状态不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 503: readonly ["SERVICE_UNAVAILABLE"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH"];
+        readonly 409: readonly ["TENANT_NOT_CURRENT", "HOSTING_EPOCH_MISMATCH", "HOSTING_HELD", "HOSTING_HOLDER_MISMATCH", "HOSTING_LEASE_EXPIRED"];
+    };
+};
+export declare const handoffHostingLease: {
+    readonly method: "post";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/lease/handoff";
+    readonly summary: "CAS 交接本人托管权";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+        readonly body: z.ZodObject<{
+            holder: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+                id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"sandbox">;
+                id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+            }, z.core.$strip>], "kind">;
+            epoch: z.ZodNumber;
+            target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+                id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"sandbox">;
+                id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+            }, z.core.$strip>], "kind">;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "托管权状态；未开通的操作同样返回 cloudEnabled=false，不创建记录";
+            readonly schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<false>;
+                serverTime: z.ZodISODateTime;
+            }, z.core.$strip>, z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<true>;
+                holder: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                    id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"sandbox">;
+                    id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+                }, z.core.$strip>], "kind">>;
+                epoch: z.ZodNumber;
+                state: z.ZodEnum<{
+                    unheld: "unheld";
+                    active: "active";
+                    expired: "expired";
+                }>;
+                leaseExpiresAt: z.ZodNullable<z.ZodISODateTime>;
+                remainingSeconds: z.ZodNumber;
+                serverTime: z.ZodISODateTime;
+                updatedAt: z.ZodISODateTime;
+            }, z.core.$strip>], "cloudEnabled">;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "租约状态不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 409: readonly ["TENANT_NOT_CURRENT", "HOSTING_EPOCH_MISMATCH", "HOSTING_HELD", "HOSTING_HOLDER_MISMATCH", "HOSTING_LEASE_EXPIRED", "LOCAL_HOST_REPLACED"];
+        readonly 503: readonly ["SERVICE_UNAVAILABLE"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH"];
+    };
+};
+/** 一条消息流的不透明游标。同一次上报里 streamId 不可重复，不含消息正文。 */
+export declare const HostingStreamCursor: z.ZodObject<{
+    streamId: z.ZodString;
+    cursor: z.ZodString;
+}, z.core.$strict>;
+export type HostingStreamCursor = z.infer<typeof HostingStreamCursor>;
+/** 各消息流游标，最多 64 条。 */
+export declare const HostingStreamCursors: z.ZodArray<z.ZodObject<{
+    streamId: z.ZodString;
+    cursor: z.ZodString;
+}, z.core.$strict>>;
+export type HostingStreamCursors = z.infer<typeof HostingStreamCursors>;
+/** 已提交事件的 sha256，不是正文摘要。 */
+export declare const HostingCheckpointSession: z.ZodObject<{
+    id: z.ZodString;
+    eventCount: z.ZodNumber;
+    digest: z.ZodString;
+}, z.core.$strict>;
+export type HostingCheckpointSession = z.infer<typeof HostingCheckpointSession>;
+/** running 正在自动接待，draining 正在排空，stopped 已停止自动接待，unavailable 无法确认仍在接待。 */
+export declare const HostingCheckpointStatus: z.ZodEnum<{
+    running: "running";
+    draining: "draining";
+    stopped: "stopped";
+    unavailable: "unavailable";
+}>;
+export type HostingCheckpointStatus = z.infer<typeof HostingCheckpointStatus>;
+/** 规范 SemVer 2.0，最多 200 字符，保留预发布和构建元数据，不接受前缀或空白。 */
+export declare const AgentConfigSemver: z.ZodString;
+/** 与 Host Agent 配置错误分类对齐；查询失败与作用域变化不计采用拒绝。 */
+export declare const AgentConfigErrorCode: z.ZodEnum<{
+    AGENT_CONFIG_QUERY_FAILED: "AGENT_CONFIG_QUERY_FAILED";
+    AGENT_CONFIG_INVALID: "AGENT_CONFIG_INVALID";
+    AGENT_CONFIG_INCOMPATIBLE: "AGENT_CONFIG_INCOMPATIBLE";
+    AGENT_CONFIG_DIGEST_MISMATCH: "AGENT_CONFIG_DIGEST_MISMATCH";
+    AGENT_CONFIG_DOWNLOAD_FAILED: "AGENT_CONFIG_DOWNLOAD_FAILED";
+    AGENT_CONFIG_APPLY_FAILED: "AGENT_CONFIG_APPLY_FAILED";
+    AGENT_CONFIG_SCOPE_CHANGED: "AGENT_CONFIG_SCOPE_CHANGED";
+}>;
+export type AgentConfigErrorCode = z.infer<typeof AgentConfigErrorCode>;
+/** 仅包含固定码与已知时的被拒版本，不包含消息、路径、URL 或凭据。 */
+export declare const AgentConfigRejection: z.ZodObject<{
+    code: z.ZodEnum<{
+        AGENT_CONFIG_QUERY_FAILED: "AGENT_CONFIG_QUERY_FAILED";
+        AGENT_CONFIG_INVALID: "AGENT_CONFIG_INVALID";
+        AGENT_CONFIG_INCOMPATIBLE: "AGENT_CONFIG_INCOMPATIBLE";
+        AGENT_CONFIG_DIGEST_MISMATCH: "AGENT_CONFIG_DIGEST_MISMATCH";
+        AGENT_CONFIG_DOWNLOAD_FAILED: "AGENT_CONFIG_DOWNLOAD_FAILED";
+        AGENT_CONFIG_APPLY_FAILED: "AGENT_CONFIG_APPLY_FAILED";
+        AGENT_CONFIG_SCOPE_CHANGED: "AGENT_CONFIG_SCOPE_CHANGED";
+    }>;
+    version: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AgentConfigRejection = z.infer<typeof AgentConfigRejection>;
+/**
+ * 某个旺旺账号的最新运行状态检查点。revision 从 1 起，跨 epoch 单调递增，不随代次重置。
+ * reportedAt 是服务端记下的上报时间，调用方用它判断是否过期。旧检查点不能作为补发依据。
+ */
+export declare const HostingCheckpoint: z.ZodObject<{
+    tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+    userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+    accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+    epoch: z.ZodNumber;
+    revision: z.ZodNumber;
+    streamCursors: z.ZodArray<z.ZodObject<{
+        streamId: z.ZodString;
+        cursor: z.ZodString;
+    }, z.core.$strict>>;
+    session: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        eventCount: z.ZodNumber;
+        digest: z.ZodString;
+    }, z.core.$strict>>;
+    pendingCount: z.ZodNumber;
+    unknownSendCount: z.ZodNumber;
+    status: z.ZodEnum<{
+        running: "running";
+        draining: "draining";
+        stopped: "stopped";
+        unavailable: "unavailable";
+    }>;
+    hostVersion: z.ZodString;
+    reportedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type HostingCheckpoint = z.infer<typeof HostingCheckpoint>;
+/**
+ * 上报当前检查点。expectedRevision 为 0 表示尚无记录，否则必须等于当前 revision。
+ * 只接受 held 且 epoch 匹配的托管租约；未开通、未持有或 epoch 不同为 HOSTING_EPOCH_MISMATCH。
+ * revision 不匹配或加一后超出安全整数为 HOSTING_REVISION_MISMATCH，且不修改记录。限制开关关闭时不比较持有者；开启时本地请求必须提供与模块名册一致的 holder。
+ */
+export declare const ReportHostingCheckpointRequest: z.ZodObject<{
+    holder: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"installation">;
+        id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"sandbox">;
+        id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+    }, z.core.$strip>], "kind">>;
+    epoch: z.ZodNumber;
+    expectedRevision: z.ZodNumber;
+    streamCursors: z.ZodArray<z.ZodObject<{
+        streamId: z.ZodString;
+        cursor: z.ZodString;
+    }, z.core.$strict>>;
+    session: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        eventCount: z.ZodNumber;
+        digest: z.ZodString;
+    }, z.core.$strict>>;
+    pendingCount: z.ZodNumber;
+    unknownSendCount: z.ZodNumber;
+    status: z.ZodEnum<{
+        running: "running";
+        draining: "draining";
+        stopped: "stopped";
+        unavailable: "unavailable";
+    }>;
+    hostVersion: z.ZodString;
+    agentConfigVersion: z.ZodOptional<z.ZodString>;
+    hostAgentConfigApiVersion: z.ZodOptional<z.ZodString>;
+    agentConfigBlocked: z.ZodOptional<z.ZodBoolean>;
+    agentConfigRejection: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        code: z.ZodEnum<{
+            AGENT_CONFIG_QUERY_FAILED: "AGENT_CONFIG_QUERY_FAILED";
+            AGENT_CONFIG_INVALID: "AGENT_CONFIG_INVALID";
+            AGENT_CONFIG_INCOMPATIBLE: "AGENT_CONFIG_INCOMPATIBLE";
+            AGENT_CONFIG_DIGEST_MISMATCH: "AGENT_CONFIG_DIGEST_MISMATCH";
+            AGENT_CONFIG_DOWNLOAD_FAILED: "AGENT_CONFIG_DOWNLOAD_FAILED";
+            AGENT_CONFIG_APPLY_FAILED: "AGENT_CONFIG_APPLY_FAILED";
+            AGENT_CONFIG_SCOPE_CHANGED: "AGENT_CONFIG_SCOPE_CHANGED";
+        }>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type ReportHostingCheckpointRequest = z.infer<typeof ReportHostingCheckpointRequest>;
+/** 读取本人该旺旺账号的最新检查点。没有记录时 404，不把缺失当成可补发的空游标。 */
+export declare const getHostingCheckpoint: {
+    readonly method: "get";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/checkpoint";
+    readonly summary: "读取本人运行状态检查点";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "最新运行状态与游标。reportedAt 为上报时间，调用方据此判断是否过期；旧检查点不能作为补发依据";
+            readonly schema: z.ZodObject<{
+                tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+                userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+                accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+                epoch: z.ZodNumber;
+                revision: z.ZodNumber;
+                streamCursors: z.ZodArray<z.ZodObject<{
+                    streamId: z.ZodString;
+                    cursor: z.ZodString;
+                }, z.core.$strict>>;
+                session: z.ZodNullable<z.ZodObject<{
+                    id: z.ZodString;
+                    eventCount: z.ZodNumber;
+                    digest: z.ZodString;
+                }, z.core.$strict>>;
+                pendingCount: z.ZodNumber;
+                unknownSendCount: z.ZodNumber;
+                status: z.ZodEnum<{
+                    running: "running";
+                    draining: "draining";
+                    stopped: "stopped";
+                    unavailable: "unavailable";
+                }>;
+                hostVersion: z.ZodString;
+                reportedAt: z.ZodISODateTime;
+            }, z.core.$strict>;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "检查点不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 404: readonly ["NOT_FOUND"];
+        readonly 503: readonly ["SERVICE_UNAVAILABLE"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH"];
+        readonly 409: readonly ["TENANT_NOT_CURRENT"];
+    };
+};
+/** 当前持有者上报。本机会话与沙箱会话都只按租约 epoch 判断，旧 epoch 或旧 revision 被拒绝。 */
+export declare const reportHostingCheckpoint: {
+    readonly method: "post";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/checkpoint";
+    readonly summary: "CAS 上报本人运行状态检查点";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+        readonly body: z.ZodObject<{
+            holder: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+                id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"sandbox">;
+                id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+            }, z.core.$strip>], "kind">>;
+            epoch: z.ZodNumber;
+            expectedRevision: z.ZodNumber;
+            streamCursors: z.ZodArray<z.ZodObject<{
+                streamId: z.ZodString;
+                cursor: z.ZodString;
+            }, z.core.$strict>>;
+            session: z.ZodNullable<z.ZodObject<{
+                id: z.ZodString;
+                eventCount: z.ZodNumber;
+                digest: z.ZodString;
+            }, z.core.$strict>>;
+            pendingCount: z.ZodNumber;
+            unknownSendCount: z.ZodNumber;
+            status: z.ZodEnum<{
+                running: "running";
+                draining: "draining";
+                stopped: "stopped";
+                unavailable: "unavailable";
+            }>;
+            hostVersion: z.ZodString;
+            agentConfigVersion: z.ZodOptional<z.ZodString>;
+            hostAgentConfigApiVersion: z.ZodOptional<z.ZodString>;
+            agentConfigBlocked: z.ZodOptional<z.ZodBoolean>;
+            agentConfigRejection: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                code: z.ZodEnum<{
+                    AGENT_CONFIG_QUERY_FAILED: "AGENT_CONFIG_QUERY_FAILED";
+                    AGENT_CONFIG_INVALID: "AGENT_CONFIG_INVALID";
+                    AGENT_CONFIG_INCOMPATIBLE: "AGENT_CONFIG_INCOMPATIBLE";
+                    AGENT_CONFIG_DIGEST_MISMATCH: "AGENT_CONFIG_DIGEST_MISMATCH";
+                    AGENT_CONFIG_DOWNLOAD_FAILED: "AGENT_CONFIG_DOWNLOAD_FAILED";
+                    AGENT_CONFIG_APPLY_FAILED: "AGENT_CONFIG_APPLY_FAILED";
+                    AGENT_CONFIG_SCOPE_CHANGED: "AGENT_CONFIG_SCOPE_CHANGED";
+                }>;
+                version: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "最新运行状态与游标。reportedAt 为上报时间，调用方据此判断是否过期；旧检查点不能作为补发依据";
+            readonly schema: z.ZodObject<{
+                tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+                userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+                accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+                epoch: z.ZodNumber;
+                revision: z.ZodNumber;
+                streamCursors: z.ZodArray<z.ZodObject<{
+                    streamId: z.ZodString;
+                    cursor: z.ZodString;
+                }, z.core.$strict>>;
+                session: z.ZodNullable<z.ZodObject<{
+                    id: z.ZodString;
+                    eventCount: z.ZodNumber;
+                    digest: z.ZodString;
+                }, z.core.$strict>>;
+                pendingCount: z.ZodNumber;
+                unknownSendCount: z.ZodNumber;
+                status: z.ZodEnum<{
+                    running: "running";
+                    draining: "draining";
+                    stopped: "stopped";
+                    unavailable: "unavailable";
+                }>;
+                hostVersion: z.ZodString;
+                reportedAt: z.ZodISODateTime;
+            }, z.core.$strict>;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "检查点不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 409: readonly ["TENANT_NOT_CURRENT", "HOSTING_EPOCH_MISMATCH", "HOSTING_REVISION_MISMATCH", "HOSTING_HOLDER_MISMATCH", "LOCAL_HOST_REPLACED"];
+        readonly 503: readonly ["SERVICE_UNAVAILABLE"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH"];
+    };
+};
+export declare const CS_HOSTING_ROUTES: readonly [{
+    readonly method: "get";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/lease";
+    readonly summary: "查询本人托管权";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "托管权状态。本账号没有记录但同一用户在其他旺旺账号上已有未过期的 active 持有者时，返回该持有者且 cloudEnabled=true。本账号已有未开通记录，或没有其他 active 持有者时，返回 cloudEnabled=false，不创建记录";
+            readonly schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<false>;
+                serverTime: z.ZodISODateTime;
+            }, z.core.$strip>, z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<true>;
+                holder: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                    id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"sandbox">;
+                    id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+                }, z.core.$strip>], "kind">>;
+                epoch: z.ZodNumber;
+                state: z.ZodEnum<{
+                    unheld: "unheld";
+                    active: "active";
+                    expired: "expired";
+                }>;
+                leaseExpiresAt: z.ZodNullable<z.ZodISODateTime>;
+                remainingSeconds: z.ZodNumber;
+                serverTime: z.ZodISODateTime;
+                updatedAt: z.ZodISODateTime;
+            }, z.core.$strip>], "cloudEnabled">;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "租约状态不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 503: readonly ["SERVICE_UNAVAILABLE"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH"];
+        readonly 409: readonly ["TENANT_NOT_CURRENT", "HOSTING_EPOCH_MISMATCH", "HOSTING_HELD", "HOSTING_HOLDER_MISMATCH", "HOSTING_LEASE_EXPIRED"];
+    };
+}, {
+    readonly method: "post";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/lease/acquire";
+    readonly summary: "CAS 取得托管租约";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+        readonly body: z.ZodObject<{
+            holder: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+                id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"sandbox">;
+                id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+            }, z.core.$strip>], "kind">;
+            expectedEpoch: z.ZodNumber;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "托管权状态。同一用户在其他旺旺账号上已有 active 持有者时回答 HOSTING_HELD，不创建记录。本账号未开通且没有其他 active 持有者时返回 cloudEnabled=false，不创建记录";
+            readonly schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<false>;
+                serverTime: z.ZodISODateTime;
+            }, z.core.$strip>, z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<true>;
+                holder: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                    id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"sandbox">;
+                    id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+                }, z.core.$strip>], "kind">>;
+                epoch: z.ZodNumber;
+                state: z.ZodEnum<{
+                    unheld: "unheld";
+                    active: "active";
+                    expired: "expired";
+                }>;
+                leaseExpiresAt: z.ZodNullable<z.ZodISODateTime>;
+                remainingSeconds: z.ZodNumber;
+                serverTime: z.ZodISODateTime;
+                updatedAt: z.ZodISODateTime;
+            }, z.core.$strip>], "cloudEnabled">;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "租约状态不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 409: readonly ["TENANT_NOT_CURRENT", "HOSTING_EPOCH_MISMATCH", "HOSTING_HELD", "HOSTING_HOLDER_MISMATCH", "HOSTING_LEASE_EXPIRED", "LOCAL_HOST_REPLACED"];
+        readonly 503: readonly ["SERVICE_UNAVAILABLE"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH"];
+    };
+}, {
+    readonly method: "post";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/lease/first-enable";
+    readonly summary: "云端沙箱首次开通本人托管权";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+        readonly body: z.ZodObject<{
+            holder: z.ZodObject<{
+                kind: z.ZodLiteral<"sandbox">;
+                id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "已开通的托管权。没有租约记录且同一用户没有其他 active 持有者时创建沙箱持有的 active 租约；同一沙箱重复调用不改变 epoch、持有者或到期时间";
+            readonly schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<false>;
+                serverTime: z.ZodISODateTime;
+            }, z.core.$strip>, z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<true>;
+                holder: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                    id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"sandbox">;
+                    id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+                }, z.core.$strip>], "kind">>;
+                epoch: z.ZodNumber;
+                state: z.ZodEnum<{
+                    unheld: "unheld";
+                    active: "active";
+                    expired: "expired";
+                }>;
+                leaseExpiresAt: z.ZodNullable<z.ZodISODateTime>;
+                remainingSeconds: z.ZodNumber;
+                serverTime: z.ZodISODateTime;
+                updatedAt: z.ZodISODateTime;
+            }, z.core.$strip>], "cloudEnabled">;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "租约状态不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH", "CLOUD_NOT_ELIGIBLE", "SANDBOX_SESSION_UNBOUND"];
+        readonly 503: readonly ["SERVICE_UNAVAILABLE"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+        readonly 409: readonly ["TENANT_NOT_CURRENT", "HOSTING_EPOCH_MISMATCH", "HOSTING_HELD", "HOSTING_HOLDER_MISMATCH", "HOSTING_LEASE_EXPIRED"];
+    };
+}, {
+    readonly method: "post";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/lease/renew";
+    readonly summary: "续约本人托管权";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+        readonly body: z.ZodObject<{
+            holder: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+                id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"sandbox">;
+                id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+            }, z.core.$strip>], "kind">;
+            epoch: z.ZodNumber;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "已续约的托管权。本机持有者未开通时返回 cloudEnabled=false 且不创建记录；沙箱持有者没有租约行，或前任观察与锁内判断不一致时不刷新租约";
+            readonly schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<false>;
+                serverTime: z.ZodISODateTime;
+            }, z.core.$strip>, z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<true>;
+                holder: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                    id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"sandbox">;
+                    id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+                }, z.core.$strip>], "kind">>;
+                epoch: z.ZodNumber;
+                state: z.ZodEnum<{
+                    unheld: "unheld";
+                    active: "active";
+                    expired: "expired";
+                }>;
+                leaseExpiresAt: z.ZodNullable<z.ZodISODateTime>;
+                remainingSeconds: z.ZodNumber;
+                serverTime: z.ZodISODateTime;
+                updatedAt: z.ZodISODateTime;
+            }, z.core.$strip>], "cloudEnabled">;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "租约状态不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH", "SANDBOX_SESSION_UNBOUND"];
+        readonly 409: readonly ["TENANT_NOT_CURRENT", "HOSTING_EPOCH_MISMATCH", "HOSTING_HELD", "HOSTING_HOLDER_MISMATCH", "HOSTING_LEASE_EXPIRED", "LOCAL_HOST_REPLACED", "PLACEMENT_KEY_NOT_READY", "PREDECESSOR_STILL_RUNNING"];
+        readonly 503: readonly ["SERVICE_UNAVAILABLE", "PREDECESSOR_EXIT_UNKNOWN"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+    };
+}, {
+    readonly method: "post";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/lease/release";
+    readonly summary: "释放本人托管权";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+        readonly body: z.ZodObject<{
+            holder: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+                id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"sandbox">;
+                id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+            }, z.core.$strip>], "kind">;
+            epoch: z.ZodNumber;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "托管权状态；未开通的操作同样返回 cloudEnabled=false，不创建记录";
+            readonly schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<false>;
+                serverTime: z.ZodISODateTime;
+            }, z.core.$strip>, z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<true>;
+                holder: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                    id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"sandbox">;
+                    id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+                }, z.core.$strip>], "kind">>;
+                epoch: z.ZodNumber;
+                state: z.ZodEnum<{
+                    unheld: "unheld";
+                    active: "active";
+                    expired: "expired";
+                }>;
+                leaseExpiresAt: z.ZodNullable<z.ZodISODateTime>;
+                remainingSeconds: z.ZodNumber;
+                serverTime: z.ZodISODateTime;
+                updatedAt: z.ZodISODateTime;
+            }, z.core.$strip>], "cloudEnabled">;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "租约状态不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 503: readonly ["SERVICE_UNAVAILABLE"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH"];
+        readonly 409: readonly ["TENANT_NOT_CURRENT", "HOSTING_EPOCH_MISMATCH", "HOSTING_HELD", "HOSTING_HOLDER_MISMATCH", "HOSTING_LEASE_EXPIRED"];
+    };
+}, {
+    readonly method: "post";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/lease/handoff";
+    readonly summary: "CAS 交接本人托管权";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+        readonly body: z.ZodObject<{
+            holder: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+                id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"sandbox">;
+                id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+            }, z.core.$strip>], "kind">;
+            epoch: z.ZodNumber;
+            target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+                id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"sandbox">;
+                id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+            }, z.core.$strip>], "kind">;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "托管权状态；未开通的操作同样返回 cloudEnabled=false，不创建记录";
+            readonly schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<false>;
+                serverTime: z.ZodISODateTime;
+            }, z.core.$strip>, z.ZodObject<{
+                cloudEnabled: z.ZodLiteral<true>;
+                holder: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                    id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"sandbox">;
+                    id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+                }, z.core.$strip>], "kind">>;
+                epoch: z.ZodNumber;
+                state: z.ZodEnum<{
+                    unheld: "unheld";
+                    active: "active";
+                    expired: "expired";
+                }>;
+                leaseExpiresAt: z.ZodNullable<z.ZodISODateTime>;
+                remainingSeconds: z.ZodNumber;
+                serverTime: z.ZodISODateTime;
+                updatedAt: z.ZodISODateTime;
+            }, z.core.$strip>], "cloudEnabled">;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "租约状态不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 409: readonly ["TENANT_NOT_CURRENT", "HOSTING_EPOCH_MISMATCH", "HOSTING_HELD", "HOSTING_HOLDER_MISMATCH", "HOSTING_LEASE_EXPIRED", "LOCAL_HOST_REPLACED"];
+        readonly 503: readonly ["SERVICE_UNAVAILABLE"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH"];
+    };
+}, {
+    readonly method: "get";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/checkpoint";
+    readonly summary: "读取本人运行状态检查点";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "最新运行状态与游标。reportedAt 为上报时间，调用方据此判断是否过期；旧检查点不能作为补发依据";
+            readonly schema: z.ZodObject<{
+                tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+                userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+                accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+                epoch: z.ZodNumber;
+                revision: z.ZodNumber;
+                streamCursors: z.ZodArray<z.ZodObject<{
+                    streamId: z.ZodString;
+                    cursor: z.ZodString;
+                }, z.core.$strict>>;
+                session: z.ZodNullable<z.ZodObject<{
+                    id: z.ZodString;
+                    eventCount: z.ZodNumber;
+                    digest: z.ZodString;
+                }, z.core.$strict>>;
+                pendingCount: z.ZodNumber;
+                unknownSendCount: z.ZodNumber;
+                status: z.ZodEnum<{
+                    running: "running";
+                    draining: "draining";
+                    stopped: "stopped";
+                    unavailable: "unavailable";
+                }>;
+                hostVersion: z.ZodString;
+                reportedAt: z.ZodISODateTime;
+            }, z.core.$strict>;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "检查点不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 404: readonly ["NOT_FOUND"];
+        readonly 503: readonly ["SERVICE_UNAVAILABLE"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH"];
+        readonly 409: readonly ["TENANT_NOT_CURRENT"];
+    };
+}, {
+    readonly method: "post";
+    readonly path: "/v1/tenants/{tenantId}/cs-hosting/users/{userId}/accounts/{accountId}/checkpoint";
+    readonly summary: "CAS 上报本人运行状态检查点";
+    readonly auth: "tenant";
+    readonly request: {
+        readonly params: z.ZodObject<{
+            tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+            userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+            accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+        }, z.core.$strip>;
+        readonly query: z.ZodObject<{}, z.core.$strict>;
+        readonly body: z.ZodObject<{
+            holder: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+                id: z.core.$ZodBranded<z.ZodUUID, "InstallationId", "out">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"sandbox">;
+                id: z.core.$ZodBranded<z.ZodString, "SandboxId", "out">;
+            }, z.core.$strip>], "kind">>;
+            epoch: z.ZodNumber;
+            expectedRevision: z.ZodNumber;
+            streamCursors: z.ZodArray<z.ZodObject<{
+                streamId: z.ZodString;
+                cursor: z.ZodString;
+            }, z.core.$strict>>;
+            session: z.ZodNullable<z.ZodObject<{
+                id: z.ZodString;
+                eventCount: z.ZodNumber;
+                digest: z.ZodString;
+            }, z.core.$strict>>;
+            pendingCount: z.ZodNumber;
+            unknownSendCount: z.ZodNumber;
+            status: z.ZodEnum<{
+                running: "running";
+                draining: "draining";
+                stopped: "stopped";
+                unavailable: "unavailable";
+            }>;
+            hostVersion: z.ZodString;
+            agentConfigVersion: z.ZodOptional<z.ZodString>;
+            hostAgentConfigApiVersion: z.ZodOptional<z.ZodString>;
+            agentConfigBlocked: z.ZodOptional<z.ZodBoolean>;
+            agentConfigRejection: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                code: z.ZodEnum<{
+                    AGENT_CONFIG_QUERY_FAILED: "AGENT_CONFIG_QUERY_FAILED";
+                    AGENT_CONFIG_INVALID: "AGENT_CONFIG_INVALID";
+                    AGENT_CONFIG_INCOMPATIBLE: "AGENT_CONFIG_INCOMPATIBLE";
+                    AGENT_CONFIG_DIGEST_MISMATCH: "AGENT_CONFIG_DIGEST_MISMATCH";
+                    AGENT_CONFIG_DOWNLOAD_FAILED: "AGENT_CONFIG_DOWNLOAD_FAILED";
+                    AGENT_CONFIG_APPLY_FAILED: "AGENT_CONFIG_APPLY_FAILED";
+                    AGENT_CONFIG_SCOPE_CHANGED: "AGENT_CONFIG_SCOPE_CHANGED";
+                }>;
+                version: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: {
+            readonly description: "最新运行状态与游标。reportedAt 为上报时间，调用方据此判断是否过期；旧检查点不能作为补发依据";
+            readonly schema: z.ZodObject<{
+                tenantId: z.core.$ZodBranded<z.ZodUUID, "TenantId", "out">;
+                userId: z.core.$ZodBranded<z.ZodUUID, "UserId", "out">;
+                accountId: z.core.$ZodBranded<z.ZodString, "WangwangAccountId", "out">;
+                epoch: z.ZodNumber;
+                revision: z.ZodNumber;
+                streamCursors: z.ZodArray<z.ZodObject<{
+                    streamId: z.ZodString;
+                    cursor: z.ZodString;
+                }, z.core.$strict>>;
+                session: z.ZodNullable<z.ZodObject<{
+                    id: z.ZodString;
+                    eventCount: z.ZodNumber;
+                    digest: z.ZodString;
+                }, z.core.$strict>>;
+                pendingCount: z.ZodNumber;
+                unknownSendCount: z.ZodNumber;
+                status: z.ZodEnum<{
+                    running: "running";
+                    draining: "draining";
+                    stopped: "stopped";
+                    unavailable: "unavailable";
+                }>;
+                hostVersion: z.ZodString;
+                reportedAt: z.ZodISODateTime;
+            }, z.core.$strict>;
+            readonly headers: {
+                readonly 'Cache-Control': {
+                    readonly description: "检查点不得缓存";
+                    readonly schema: z.ZodLiteral<"no-store">;
+                };
+            };
+        };
+    };
+    readonly problems: {
+        readonly 409: readonly ["TENANT_NOT_CURRENT", "HOSTING_EPOCH_MISMATCH", "HOSTING_REVISION_MISMATCH", "HOSTING_HOLDER_MISMATCH", "LOCAL_HOST_REPLACED"];
+        readonly 503: readonly ["SERVICE_UNAVAILABLE"];
+        readonly 401: readonly ["SESSION_REQUIRED", "SESSION_EXPIRED"];
+        readonly 403: readonly ["NO_CURRENT_TENANT", "NOT_A_MEMBER", "HOSTING_UNAVAILABLE", "HOSTING_USER_MISMATCH"];
+    };
+}];