@helyx/bot 0.3.1 → 0.4.2

package/dist/shard-contracts.d.ts

@@ -0,0 +1,751 @@
+import { z } from "zod";
+import type { BotControlHandler } from "./control-server.js";
+export declare const SHARD_CONTRACT_VERSION: 1;
+export declare const SHARD_CONTROL_MAX_BYTES: number;
+export declare const SHARD_CONTROL_TIMEOUT_MS = 10000;
+export declare const SHARD_HEALTH_STALE_MS = 30000;
+export declare const SHARD_LEASE_HEARTBEAT_TIMEOUT_MS = 20000;
+export declare const shardIdentitySchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    mode: z.ZodEnum<{
+        fixed: "fixed";
+        auto: "auto";
+    }>;
+    scope: z.ZodEnum<{
+        local: "local";
+        coordinated: "coordinated";
+    }>;
+    generation: z.ZodString;
+    deploymentOrder: z.ZodOptional<z.ZodNumber>;
+    supervisorId: z.ZodUUID;
+    shardId: z.ZodNumber;
+    shardCount: z.ZodNumber;
+    fencingToken: z.ZodNumber;
+}, z.core.$strict>;
+export type ShardIdentity = z.infer<typeof shardIdentitySchema>;
+export declare const gatewayBotInformationSchema: z.ZodObject<{
+    url: z.ZodURL;
+    shards: z.ZodNumber;
+    session_start_limit: z.ZodObject<{
+        total: z.ZodNumber;
+        remaining: z.ZodNumber;
+        reset_after: z.ZodNumber;
+        max_concurrency: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type GatewayBotInformation = z.infer<typeof gatewayBotInformationSchema>;
+export declare const shardProcessHealthSchema: z.ZodObject<{
+    shardId: z.ZodNumber;
+    status: z.ZodEnum<{
+        ready: "ready";
+        starting: "starting";
+        disconnected: "disconnected";
+        reconnecting: "reconnecting";
+        stopped: "stopped";
+        failed: "failed";
+    }>;
+    guildCount: z.ZodNumber;
+    gatewayPingMs: z.ZodNumber;
+    uptimeSeconds: z.ZodNumber;
+    restartCount: z.ZodNumber;
+    eventLoopDelayMs: z.ZodNumber;
+    memoryRssBytes: z.ZodNumber;
+    queueDepth: z.ZodNumber;
+    observedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type ShardProcessHealth = z.infer<typeof shardProcessHealthSchema>;
+export declare const shardHealthSnapshotSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    mode: z.ZodEnum<{
+        fixed: "fixed";
+        auto: "auto";
+        off: "off";
+    }>;
+    scope: z.ZodEnum<{
+        local: "local";
+        coordinated: "coordinated";
+    }>;
+    status: z.ZodEnum<{
+        starting: "starting";
+        healthy: "healthy";
+        degraded: "degraded";
+        unavailable: "unavailable";
+        stale: "stale";
+    }>;
+    observedAt: z.ZodISODateTime;
+    generation: z.ZodString;
+    supervisorId: z.ZodUUID;
+    configuredShardCount: z.ZodNumber;
+    readyShardCount: z.ZodNumber;
+    coordination: z.ZodObject<{
+        redis: z.ZodEnum<{
+            healthy: "healthy";
+            degraded: "degraded";
+            unavailable: "unavailable";
+            not_required: "not_required";
+        }>;
+        database: z.ZodEnum<{
+            healthy: "healthy";
+            degraded: "degraded";
+            unavailable: "unavailable";
+        }>;
+    }, z.core.$strict>;
+    sessionStarts: z.ZodOptional<z.ZodObject<{
+        total: z.ZodNumber;
+        remaining: z.ZodNumber;
+        resetAt: z.ZodISODateTime;
+        maxConcurrency: z.ZodNumber;
+        observedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    shards: z.ZodArray<z.ZodObject<{
+        shardId: z.ZodNumber;
+        status: z.ZodEnum<{
+            ready: "ready";
+            starting: "starting";
+            disconnected: "disconnected";
+            reconnecting: "reconnecting";
+            stopped: "stopped";
+            failed: "failed";
+        }>;
+        guildCount: z.ZodNumber;
+        gatewayPingMs: z.ZodNumber;
+        uptimeSeconds: z.ZodNumber;
+        restartCount: z.ZodNumber;
+        eventLoopDelayMs: z.ZodNumber;
+        memoryRssBytes: z.ZodNumber;
+        queueDepth: z.ZodNumber;
+        observedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ShardHealthSnapshot = z.infer<typeof shardHealthSnapshotSchema>;
+export declare const shardControlOperationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"guild.state.get">;
+    guildId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    actorUserId: z.ZodString;
+    correlationId: z.ZodString;
+    kind: z.ZodLiteral<"guild.module.status.set">;
+    guildId: z.ZodString;
+    moduleId: z.ZodString;
+    enabled: z.ZodBoolean;
+}, z.core.$strict>, z.ZodObject<{
+    actorUserId: z.ZodString;
+    correlationId: z.ZodString;
+    kind: z.ZodLiteral<"guild.module.configuration.update">;
+    guildId: z.ZodString;
+    moduleId: z.ZodString;
+    value: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodString>]>>;
+    expectedVersion: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    actorUserId: z.ZodString;
+    correlationId: z.ZodString;
+    kind: z.ZodLiteral<"guild.module.permissions.update">;
+    guildId: z.ZodString;
+    moduleId: z.ZodString;
+    state: z.ZodObject<{
+        version: z.ZodNumber;
+        module: z.ZodObject<{
+            preset: z.ZodEnum<{
+                everyone: "everyone";
+                moderators: "moderators";
+                administrators: "administrators";
+                custom: "custom";
+            }>;
+            allowedRoleIds: z.ZodArray<z.ZodString>;
+            deniedRoleIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        commands: z.ZodArray<z.ZodObject<{
+            commandId: z.ZodString;
+            version: z.ZodNumber;
+            enabled: z.ZodBoolean;
+            policy: z.ZodObject<{
+                preset: z.ZodEnum<{
+                    everyone: "everyone";
+                    moderators: "moderators";
+                    administrators: "administrators";
+                    custom: "custom";
+                }>;
+                allowedRoleIds: z.ZodArray<z.ZodString>;
+                deniedRoleIds: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    actorUserId: z.ZodString;
+    correlationId: z.ZodString;
+    kind: z.ZodLiteral<"guild.module.logging.update">;
+    guildId: z.ZodString;
+    moduleId: z.ZodString;
+    eventId: z.ZodString;
+    enabled: z.ZodBoolean;
+    expectedVersion: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    actorUserId: z.ZodString;
+    correlationId: z.ZodString;
+    kind: z.ZodLiteral<"guild.module.action.execute">;
+    guildId: z.ZodString;
+    moduleId: z.ZodString;
+    actionId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"privacy.providers.list">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"privacy.capture">;
+    providerId: z.ZodString;
+    providerVersion: z.ZodNumber;
+    requestId: z.ZodUUID;
+    subjectUserId: z.ZodString;
+    cutoffAt: z.ZodISODateTime;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"privacy.erase">;
+    providerId: z.ZodString;
+    providerVersion: z.ZodNumber;
+    requestId: z.ZodUUID;
+    subjectUserId: z.ZodString;
+    executeThrough: z.ZodISODateTime;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "kind">;
+export type ShardControlOperation = z.infer<typeof shardControlOperationSchema>;
+export declare const shardControlRequestSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.control.request">;
+    requestId: z.ZodUUID;
+    generation: z.ZodString;
+    fencingToken: z.ZodNumber;
+    deadlineAt: z.ZodISODateTime;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"guild.state.get">;
+        guildId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        actorUserId: z.ZodString;
+        correlationId: z.ZodString;
+        kind: z.ZodLiteral<"guild.module.status.set">;
+        guildId: z.ZodString;
+        moduleId: z.ZodString;
+        enabled: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        actorUserId: z.ZodString;
+        correlationId: z.ZodString;
+        kind: z.ZodLiteral<"guild.module.configuration.update">;
+        guildId: z.ZodString;
+        moduleId: z.ZodString;
+        value: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodString>]>>;
+        expectedVersion: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        actorUserId: z.ZodString;
+        correlationId: z.ZodString;
+        kind: z.ZodLiteral<"guild.module.permissions.update">;
+        guildId: z.ZodString;
+        moduleId: z.ZodString;
+        state: z.ZodObject<{
+            version: z.ZodNumber;
+            module: z.ZodObject<{
+                preset: z.ZodEnum<{
+                    everyone: "everyone";
+                    moderators: "moderators";
+                    administrators: "administrators";
+                    custom: "custom";
+                }>;
+                allowedRoleIds: z.ZodArray<z.ZodString>;
+                deniedRoleIds: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            commands: z.ZodArray<z.ZodObject<{
+                commandId: z.ZodString;
+                version: z.ZodNumber;
+                enabled: z.ZodBoolean;
+                policy: z.ZodObject<{
+                    preset: z.ZodEnum<{
+                        everyone: "everyone";
+                        moderators: "moderators";
+                        administrators: "administrators";
+                        custom: "custom";
+                    }>;
+                    allowedRoleIds: z.ZodArray<z.ZodString>;
+                    deniedRoleIds: z.ZodArray<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        actorUserId: z.ZodString;
+        correlationId: z.ZodString;
+        kind: z.ZodLiteral<"guild.module.logging.update">;
+        guildId: z.ZodString;
+        moduleId: z.ZodString;
+        eventId: z.ZodString;
+        enabled: z.ZodBoolean;
+        expectedVersion: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        actorUserId: z.ZodString;
+        correlationId: z.ZodString;
+        kind: z.ZodLiteral<"guild.module.action.execute">;
+        guildId: z.ZodString;
+        moduleId: z.ZodString;
+        actionId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"privacy.providers.list">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"privacy.capture">;
+        providerId: z.ZodString;
+        providerVersion: z.ZodNumber;
+        requestId: z.ZodUUID;
+        subjectUserId: z.ZodString;
+        cutoffAt: z.ZodISODateTime;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"privacy.erase">;
+        providerId: z.ZodString;
+        providerVersion: z.ZodNumber;
+        requestId: z.ZodUUID;
+        subjectUserId: z.ZodString;
+        executeThrough: z.ZodISODateTime;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>;
+export type ShardControlRequest = z.infer<typeof shardControlRequestSchema>;
+export declare const shardControlResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.control.response">;
+    requestId: z.ZodUUID;
+    ok: z.ZodLiteral<true>;
+    result: z.ZodUnknown;
+}, z.core.$strict>, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.control.response">;
+    requestId: z.ZodUUID;
+    ok: z.ZodLiteral<false>;
+    status: z.ZodNumber;
+    message: z.ZodString;
+}, z.core.$strict>], "ok">;
+export type ShardControlResponse = z.infer<typeof shardControlResponseSchema>;
+declare const shardCloudOperationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"cloud.status">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"cloud.consent.get">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"cloud.consent.update">;
+    supportInspectionEnabled: z.ZodBoolean;
+    supportDataClasses: z.ZodArray<z.ZodString>;
+    diagnosticsEnabled: z.ZodBoolean;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"cloud.enrol">;
+    token: z.ZodString;
+    source: z.ZodEnum<{
+        file: "file";
+        discord: "discord";
+        startup: "startup";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"cloud.disconnect">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"cloud.rotate">;
+}, z.core.$strict>], "kind">;
+export type ShardCloudOperation = z.infer<typeof shardCloudOperationSchema>;
+export declare const shardCloudRequestSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.cloud.request">;
+    requestId: z.ZodUUID;
+    deadlineAt: z.ZodISODateTime;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"cloud.status">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cloud.consent.get">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cloud.consent.update">;
+        supportInspectionEnabled: z.ZodBoolean;
+        supportDataClasses: z.ZodArray<z.ZodString>;
+        diagnosticsEnabled: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cloud.enrol">;
+        token: z.ZodString;
+        source: z.ZodEnum<{
+            file: "file";
+            discord: "discord";
+            startup: "startup";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cloud.disconnect">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cloud.rotate">;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>;
+export declare const shardCloudResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.cloud.response">;
+    requestId: z.ZodUUID;
+    ok: z.ZodLiteral<true>;
+    result: z.ZodUnknown;
+}, z.core.$strict>, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.cloud.response">;
+    requestId: z.ZodUUID;
+    ok: z.ZodLiteral<false>;
+    message: z.ZodString;
+}, z.core.$strict>], "ok">;
+export type ShardCloudRequest = z.infer<typeof shardCloudRequestSchema>;
+export type ShardCloudResponse = z.infer<typeof shardCloudResponseSchema>;
+export declare const shardOperationsHealthRequestSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.operations.health.request">;
+    requestId: z.ZodUUID;
+    deadlineAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const shardOperationsHealthResponseSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.operations.health.response">;
+    requestId: z.ZodUUID;
+    health: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        mode: z.ZodEnum<{
+            fixed: "fixed";
+            auto: "auto";
+            off: "off";
+        }>;
+        scope: z.ZodEnum<{
+            local: "local";
+            coordinated: "coordinated";
+        }>;
+        status: z.ZodEnum<{
+            starting: "starting";
+            healthy: "healthy";
+            degraded: "degraded";
+            unavailable: "unavailable";
+            stale: "stale";
+        }>;
+        observedAt: z.ZodISODateTime;
+        generation: z.ZodString;
+        supervisorId: z.ZodUUID;
+        configuredShardCount: z.ZodNumber;
+        readyShardCount: z.ZodNumber;
+        coordination: z.ZodObject<{
+            redis: z.ZodEnum<{
+                healthy: "healthy";
+                degraded: "degraded";
+                unavailable: "unavailable";
+                not_required: "not_required";
+            }>;
+            database: z.ZodEnum<{
+                healthy: "healthy";
+                degraded: "degraded";
+                unavailable: "unavailable";
+            }>;
+        }, z.core.$strict>;
+        sessionStarts: z.ZodOptional<z.ZodObject<{
+            total: z.ZodNumber;
+            remaining: z.ZodNumber;
+            resetAt: z.ZodISODateTime;
+            maxConcurrency: z.ZodNumber;
+            observedAt: z.ZodISODateTime;
+        }, z.core.$strict>>;
+        shards: z.ZodArray<z.ZodObject<{
+            shardId: z.ZodNumber;
+            status: z.ZodEnum<{
+                ready: "ready";
+                starting: "starting";
+                disconnected: "disconnected";
+                reconnecting: "reconnecting";
+                stopped: "stopped";
+                failed: "failed";
+            }>;
+            guildCount: z.ZodNumber;
+            gatewayPingMs: z.ZodNumber;
+            uptimeSeconds: z.ZodNumber;
+            restartCount: z.ZodNumber;
+            eventLoopDelayMs: z.ZodNumber;
+            memoryRssBytes: z.ZodNumber;
+            queueDepth: z.ZodNumber;
+            observedAt: z.ZodISODateTime;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const supervisorMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.control.request">;
+    requestId: z.ZodUUID;
+    generation: z.ZodString;
+    fencingToken: z.ZodNumber;
+    deadlineAt: z.ZodISODateTime;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"guild.state.get">;
+        guildId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        actorUserId: z.ZodString;
+        correlationId: z.ZodString;
+        kind: z.ZodLiteral<"guild.module.status.set">;
+        guildId: z.ZodString;
+        moduleId: z.ZodString;
+        enabled: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        actorUserId: z.ZodString;
+        correlationId: z.ZodString;
+        kind: z.ZodLiteral<"guild.module.configuration.update">;
+        guildId: z.ZodString;
+        moduleId: z.ZodString;
+        value: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodString>]>>;
+        expectedVersion: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        actorUserId: z.ZodString;
+        correlationId: z.ZodString;
+        kind: z.ZodLiteral<"guild.module.permissions.update">;
+        guildId: z.ZodString;
+        moduleId: z.ZodString;
+        state: z.ZodObject<{
+            version: z.ZodNumber;
+            module: z.ZodObject<{
+                preset: z.ZodEnum<{
+                    everyone: "everyone";
+                    moderators: "moderators";
+                    administrators: "administrators";
+                    custom: "custom";
+                }>;
+                allowedRoleIds: z.ZodArray<z.ZodString>;
+                deniedRoleIds: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            commands: z.ZodArray<z.ZodObject<{
+                commandId: z.ZodString;
+                version: z.ZodNumber;
+                enabled: z.ZodBoolean;
+                policy: z.ZodObject<{
+                    preset: z.ZodEnum<{
+                        everyone: "everyone";
+                        moderators: "moderators";
+                        administrators: "administrators";
+                        custom: "custom";
+                    }>;
+                    allowedRoleIds: z.ZodArray<z.ZodString>;
+                    deniedRoleIds: z.ZodArray<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        actorUserId: z.ZodString;
+        correlationId: z.ZodString;
+        kind: z.ZodLiteral<"guild.module.logging.update">;
+        guildId: z.ZodString;
+        moduleId: z.ZodString;
+        eventId: z.ZodString;
+        enabled: z.ZodBoolean;
+        expectedVersion: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        actorUserId: z.ZodString;
+        correlationId: z.ZodString;
+        kind: z.ZodLiteral<"guild.module.action.execute">;
+        guildId: z.ZodString;
+        moduleId: z.ZodString;
+        actionId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"privacy.providers.list">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"privacy.capture">;
+        providerId: z.ZodString;
+        providerVersion: z.ZodNumber;
+        requestId: z.ZodUUID;
+        subjectUserId: z.ZodString;
+        cutoffAt: z.ZodISODateTime;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"privacy.erase">;
+        providerId: z.ZodString;
+        providerVersion: z.ZodNumber;
+        requestId: z.ZodUUID;
+        subjectUserId: z.ZodString;
+        executeThrough: z.ZodISODateTime;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.cloud.response">;
+    requestId: z.ZodUUID;
+    ok: z.ZodLiteral<true>;
+    result: z.ZodUnknown;
+}, z.core.$strict>, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.cloud.response">;
+    requestId: z.ZodUUID;
+    ok: z.ZodLiteral<false>;
+    message: z.ZodString;
+}, z.core.$strict>], "ok">, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.operations.health.response">;
+    requestId: z.ZodUUID;
+    health: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        mode: z.ZodEnum<{
+            fixed: "fixed";
+            auto: "auto";
+            off: "off";
+        }>;
+        scope: z.ZodEnum<{
+            local: "local";
+            coordinated: "coordinated";
+        }>;
+        status: z.ZodEnum<{
+            starting: "starting";
+            healthy: "healthy";
+            degraded: "degraded";
+            unavailable: "unavailable";
+            stale: "stale";
+        }>;
+        observedAt: z.ZodISODateTime;
+        generation: z.ZodString;
+        supervisorId: z.ZodUUID;
+        configuredShardCount: z.ZodNumber;
+        readyShardCount: z.ZodNumber;
+        coordination: z.ZodObject<{
+            redis: z.ZodEnum<{
+                healthy: "healthy";
+                degraded: "degraded";
+                unavailable: "unavailable";
+                not_required: "not_required";
+            }>;
+            database: z.ZodEnum<{
+                healthy: "healthy";
+                degraded: "degraded";
+                unavailable: "unavailable";
+            }>;
+        }, z.core.$strict>;
+        sessionStarts: z.ZodOptional<z.ZodObject<{
+            total: z.ZodNumber;
+            remaining: z.ZodNumber;
+            resetAt: z.ZodISODateTime;
+            maxConcurrency: z.ZodNumber;
+            observedAt: z.ZodISODateTime;
+        }, z.core.$strict>>;
+        shards: z.ZodArray<z.ZodObject<{
+            shardId: z.ZodNumber;
+            status: z.ZodEnum<{
+                ready: "ready";
+                starting: "starting";
+                disconnected: "disconnected";
+                reconnecting: "reconnecting";
+                stopped: "stopped";
+                failed: "failed";
+            }>;
+            guildCount: z.ZodNumber;
+            gatewayPingMs: z.ZodNumber;
+            uptimeSeconds: z.ZodNumber;
+            restartCount: z.ZodNumber;
+            eventLoopDelayMs: z.ZodNumber;
+            memoryRssBytes: z.ZodNumber;
+            queueDepth: z.ZodNumber;
+            observedAt: z.ZodISODateTime;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.lease.heartbeat">;
+    identity: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        mode: z.ZodEnum<{
+            fixed: "fixed";
+            auto: "auto";
+        }>;
+        scope: z.ZodEnum<{
+            local: "local";
+            coordinated: "coordinated";
+        }>;
+        generation: z.ZodString;
+        deploymentOrder: z.ZodOptional<z.ZodNumber>;
+        supervisorId: z.ZodUUID;
+        shardId: z.ZodNumber;
+        shardCount: z.ZodNumber;
+        fencingToken: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.health.request">;
+}, z.core.$strict>, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.shutdown">;
+    reason: z.ZodString;
+}, z.core.$strict>], "type">;
+export declare const workerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodDiscriminatedUnion<[z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.control.response">;
+    requestId: z.ZodUUID;
+    ok: z.ZodLiteral<true>;
+    result: z.ZodUnknown;
+}, z.core.$strict>, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.control.response">;
+    requestId: z.ZodUUID;
+    ok: z.ZodLiteral<false>;
+    status: z.ZodNumber;
+    message: z.ZodString;
+}, z.core.$strict>], "ok">, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.cloud.request">;
+    requestId: z.ZodUUID;
+    deadlineAt: z.ZodISODateTime;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"cloud.status">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cloud.consent.get">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cloud.consent.update">;
+        supportInspectionEnabled: z.ZodBoolean;
+        supportDataClasses: z.ZodArray<z.ZodString>;
+        diagnosticsEnabled: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cloud.enrol">;
+        token: z.ZodString;
+        source: z.ZodEnum<{
+            file: "file";
+            discord: "discord";
+            startup: "startup";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cloud.disconnect">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cloud.rotate">;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.operations.health.request">;
+    requestId: z.ZodUUID;
+    deadlineAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"helyx.health.update">;
+    identity: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        mode: z.ZodEnum<{
+            fixed: "fixed";
+            auto: "auto";
+        }>;
+        scope: z.ZodEnum<{
+            local: "local";
+            coordinated: "coordinated";
+        }>;
+        generation: z.ZodString;
+        deploymentOrder: z.ZodOptional<z.ZodNumber>;
+        supervisorId: z.ZodUUID;
+        shardId: z.ZodNumber;
+        shardCount: z.ZodNumber;
+        fencingToken: z.ZodNumber;
+    }, z.core.$strict>;
+    health: z.ZodObject<{
+        shardId: z.ZodNumber;
+        status: z.ZodEnum<{
+            ready: "ready";
+            starting: "starting";
+            disconnected: "disconnected";
+            reconnecting: "reconnecting";
+            stopped: "stopped";
+            failed: "failed";
+        }>;
+        guildCount: z.ZodNumber;
+        gatewayPingMs: z.ZodNumber;
+        uptimeSeconds: z.ZodNumber;
+        restartCount: z.ZodNumber;
+        eventLoopDelayMs: z.ZodNumber;
+        memoryRssBytes: z.ZodNumber;
+        queueDepth: z.ZodNumber;
+        observedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+}, z.core.$strict>], "type">;
+export declare function guildIdToShardId(guildId: string, shardCount: number): number;
+export declare function controlOperationGuildId(operation: ShardControlOperation): string | undefined;
+export declare function assertShardMessageSize(value: unknown): void;
+export declare function executeShardControlOperation(handler: BotControlHandler, operation: ShardControlOperation): Promise<unknown>;
+export {};
+//# sourceMappingURL=shard-contracts.d.ts.map