@treeseed/sdk 0.13.0-rc.50 → 0.13.0-rc.52

package/dist/deployment/ai-mode.d.ts

@@ -0,0 +1,454 @@
+import { z } from 'zod';
+export declare const AI_MODE_INTERNAL_PATH: string;
+export declare const aiModeSchema: z.ZodEnum<["awake", "sleep"]>;
+export type AiMode = z.infer<typeof aiModeSchema>;
+export declare const aiModeFingerprintSchema: z.ZodObject<{
+    inferenceRuntimeDigest: z.ZodString;
+    trainingRuntimeDigest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    inferenceRuntimeDigest: string;
+    trainingRuntimeDigest: string;
+}, {
+    inferenceRuntimeDigest: string;
+    trainingRuntimeDigest: string;
+}>;
+export type AiModeFingerprint = z.infer<typeof aiModeFingerprintSchema>;
+export declare const aiModeRequestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"treeseed.ai-mode-request/v1">;
+    target: z.ZodEnum<["awake", "sleep"]>;
+    idempotencyKey: z.ZodString;
+    drainTimeoutSeconds: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    target: "awake" | "sleep";
+    schemaVersion: "treeseed.ai-mode-request/v1";
+    idempotencyKey: string;
+    drainTimeoutSeconds: number;
+}, {
+    target: "awake" | "sleep";
+    schemaVersion: "treeseed.ai-mode-request/v1";
+    idempotencyKey: string;
+    drainTimeoutSeconds?: number | undefined;
+}>;
+export declare const aiModeTransitionStepSchema: z.ZodObject<{
+    id: z.ZodEnum<["close-inference", "drain-inference", "stop-vllm", "start-training", "open-training", "close-training", "drain-training", "stop-training", "start-vllm", "warm-vllm", "open-inference", "rollback"]>;
+    state: z.ZodEnum<["pending", "running", "succeeded", "skipped", "failed"]>;
+    completedAt: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+    state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+    completedAt: string | null;
+}, {
+    id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+    state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+    completedAt: string | null;
+}>;
+export declare const aiModeTransitionReceiptSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"treeseed.ai-mode-transition-receipt/v1">;
+    transitionId: z.ZodString;
+    idempotencyKey: z.ZodString;
+    resource: z.ZodLiteral<"ai-gpu">;
+    requestedBy: z.ZodEnum<["operator", "ai-lab"]>;
+    from: z.ZodEnum<["awake", "sleep"]>;
+    to: z.ZodEnum<["awake", "sleep"]>;
+    state: z.ZodEnum<["planned", "running", "succeeded", "postponed", "rolled-back", "degraded"]>;
+    reason: z.ZodNullable<z.ZodEnum<["active-inference", "active-training", "transition-failed", "recovery-failed"]>>;
+    fingerprint: z.ZodObject<{
+        inferenceRuntimeDigest: z.ZodString;
+        trainingRuntimeDigest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        inferenceRuntimeDigest: string;
+        trainingRuntimeDigest: string;
+    }, {
+        inferenceRuntimeDigest: string;
+        trainingRuntimeDigest: string;
+    }>;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodEnum<["close-inference", "drain-inference", "stop-vllm", "start-training", "open-training", "close-training", "drain-training", "stop-training", "start-vllm", "warm-vllm", "open-inference", "rollback"]>;
+        state: z.ZodEnum<["pending", "running", "succeeded", "skipped", "failed"]>;
+        completedAt: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+        state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+        completedAt: string | null;
+    }, {
+        id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+        state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+        completedAt: string | null;
+    }>, "many">;
+    startedAt: z.ZodString;
+    completedAt: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: "treeseed.ai-mode-transition-receipt/v1";
+    state: "degraded" | "running" | "succeeded" | "planned" | "postponed" | "rolled-back";
+    resource: "ai-gpu";
+    completedAt: string | null;
+    idempotencyKey: string;
+    transitionId: string;
+    requestedBy: "operator" | "ai-lab";
+    from: "awake" | "sleep";
+    to: "awake" | "sleep";
+    reason: "active-inference" | "active-training" | "transition-failed" | "recovery-failed" | null;
+    fingerprint: {
+        inferenceRuntimeDigest: string;
+        trainingRuntimeDigest: string;
+    };
+    steps: {
+        id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+        state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+        completedAt: string | null;
+    }[];
+    startedAt: string;
+}, {
+    schemaVersion: "treeseed.ai-mode-transition-receipt/v1";
+    state: "degraded" | "running" | "succeeded" | "planned" | "postponed" | "rolled-back";
+    resource: "ai-gpu";
+    completedAt: string | null;
+    idempotencyKey: string;
+    transitionId: string;
+    requestedBy: "operator" | "ai-lab";
+    from: "awake" | "sleep";
+    to: "awake" | "sleep";
+    reason: "active-inference" | "active-training" | "transition-failed" | "recovery-failed" | null;
+    fingerprint: {
+        inferenceRuntimeDigest: string;
+        trainingRuntimeDigest: string;
+    };
+    steps: {
+        id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+        state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+        completedAt: string | null;
+    }[];
+    startedAt: string;
+}>;
+export declare const aiModeStatusSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"treeseed.ai-mode-status/v1">;
+    resource: z.ZodLiteral<"ai-gpu">;
+    available: z.ZodBoolean;
+    mode: z.ZodEnum<["awake", "sleep", "transitioning-awake", "transitioning-sleep", "degraded", "unavailable"]>;
+    fingerprint: z.ZodNullable<z.ZodObject<{
+        inferenceRuntimeDigest: z.ZodString;
+        trainingRuntimeDigest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        inferenceRuntimeDigest: string;
+        trainingRuntimeDigest: string;
+    }, {
+        inferenceRuntimeDigest: string;
+        trainingRuntimeDigest: string;
+    }>>;
+    activeTransition: z.ZodNullable<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"treeseed.ai-mode-transition-receipt/v1">;
+        transitionId: z.ZodString;
+        idempotencyKey: z.ZodString;
+        resource: z.ZodLiteral<"ai-gpu">;
+        requestedBy: z.ZodEnum<["operator", "ai-lab"]>;
+        from: z.ZodEnum<["awake", "sleep"]>;
+        to: z.ZodEnum<["awake", "sleep"]>;
+        state: z.ZodEnum<["planned", "running", "succeeded", "postponed", "rolled-back", "degraded"]>;
+        reason: z.ZodNullable<z.ZodEnum<["active-inference", "active-training", "transition-failed", "recovery-failed"]>>;
+        fingerprint: z.ZodObject<{
+            inferenceRuntimeDigest: z.ZodString;
+            trainingRuntimeDigest: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            inferenceRuntimeDigest: string;
+            trainingRuntimeDigest: string;
+        }, {
+            inferenceRuntimeDigest: string;
+            trainingRuntimeDigest: string;
+        }>;
+        steps: z.ZodArray<z.ZodObject<{
+            id: z.ZodEnum<["close-inference", "drain-inference", "stop-vllm", "start-training", "open-training", "close-training", "drain-training", "stop-training", "start-vllm", "warm-vllm", "open-inference", "rollback"]>;
+            state: z.ZodEnum<["pending", "running", "succeeded", "skipped", "failed"]>;
+            completedAt: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+            state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+            completedAt: string | null;
+        }, {
+            id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+            state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+            completedAt: string | null;
+        }>, "many">;
+        startedAt: z.ZodString;
+        completedAt: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        schemaVersion: "treeseed.ai-mode-transition-receipt/v1";
+        state: "degraded" | "running" | "succeeded" | "planned" | "postponed" | "rolled-back";
+        resource: "ai-gpu";
+        completedAt: string | null;
+        idempotencyKey: string;
+        transitionId: string;
+        requestedBy: "operator" | "ai-lab";
+        from: "awake" | "sleep";
+        to: "awake" | "sleep";
+        reason: "active-inference" | "active-training" | "transition-failed" | "recovery-failed" | null;
+        fingerprint: {
+            inferenceRuntimeDigest: string;
+            trainingRuntimeDigest: string;
+        };
+        steps: {
+            id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+            state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+            completedAt: string | null;
+        }[];
+        startedAt: string;
+    }, {
+        schemaVersion: "treeseed.ai-mode-transition-receipt/v1";
+        state: "degraded" | "running" | "succeeded" | "planned" | "postponed" | "rolled-back";
+        resource: "ai-gpu";
+        completedAt: string | null;
+        idempotencyKey: string;
+        transitionId: string;
+        requestedBy: "operator" | "ai-lab";
+        from: "awake" | "sleep";
+        to: "awake" | "sleep";
+        reason: "active-inference" | "active-training" | "transition-failed" | "recovery-failed" | null;
+        fingerprint: {
+            inferenceRuntimeDigest: string;
+            trainingRuntimeDigest: string;
+        };
+        steps: {
+            id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+            state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+            completedAt: string | null;
+        }[];
+        startedAt: string;
+    }>>;
+    lastReceipt: z.ZodNullable<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"treeseed.ai-mode-transition-receipt/v1">;
+        transitionId: z.ZodString;
+        idempotencyKey: z.ZodString;
+        resource: z.ZodLiteral<"ai-gpu">;
+        requestedBy: z.ZodEnum<["operator", "ai-lab"]>;
+        from: z.ZodEnum<["awake", "sleep"]>;
+        to: z.ZodEnum<["awake", "sleep"]>;
+        state: z.ZodEnum<["planned", "running", "succeeded", "postponed", "rolled-back", "degraded"]>;
+        reason: z.ZodNullable<z.ZodEnum<["active-inference", "active-training", "transition-failed", "recovery-failed"]>>;
+        fingerprint: z.ZodObject<{
+            inferenceRuntimeDigest: z.ZodString;
+            trainingRuntimeDigest: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            inferenceRuntimeDigest: string;
+            trainingRuntimeDigest: string;
+        }, {
+            inferenceRuntimeDigest: string;
+            trainingRuntimeDigest: string;
+        }>;
+        steps: z.ZodArray<z.ZodObject<{
+            id: z.ZodEnum<["close-inference", "drain-inference", "stop-vllm", "start-training", "open-training", "close-training", "drain-training", "stop-training", "start-vllm", "warm-vllm", "open-inference", "rollback"]>;
+            state: z.ZodEnum<["pending", "running", "succeeded", "skipped", "failed"]>;
+            completedAt: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+            state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+            completedAt: string | null;
+        }, {
+            id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+            state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+            completedAt: string | null;
+        }>, "many">;
+        startedAt: z.ZodString;
+        completedAt: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        schemaVersion: "treeseed.ai-mode-transition-receipt/v1";
+        state: "degraded" | "running" | "succeeded" | "planned" | "postponed" | "rolled-back";
+        resource: "ai-gpu";
+        completedAt: string | null;
+        idempotencyKey: string;
+        transitionId: string;
+        requestedBy: "operator" | "ai-lab";
+        from: "awake" | "sleep";
+        to: "awake" | "sleep";
+        reason: "active-inference" | "active-training" | "transition-failed" | "recovery-failed" | null;
+        fingerprint: {
+            inferenceRuntimeDigest: string;
+            trainingRuntimeDigest: string;
+        };
+        steps: {
+            id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+            state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+            completedAt: string | null;
+        }[];
+        startedAt: string;
+    }, {
+        schemaVersion: "treeseed.ai-mode-transition-receipt/v1";
+        state: "degraded" | "running" | "succeeded" | "planned" | "postponed" | "rolled-back";
+        resource: "ai-gpu";
+        completedAt: string | null;
+        idempotencyKey: string;
+        transitionId: string;
+        requestedBy: "operator" | "ai-lab";
+        from: "awake" | "sleep";
+        to: "awake" | "sleep";
+        reason: "active-inference" | "active-training" | "transition-failed" | "recovery-failed" | null;
+        fingerprint: {
+            inferenceRuntimeDigest: string;
+            trainingRuntimeDigest: string;
+        };
+        steps: {
+            id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+            state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+            completedAt: string | null;
+        }[];
+        startedAt: string;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: "treeseed.ai-mode-status/v1";
+    mode: "degraded" | "awake" | "sleep" | "transitioning-awake" | "transitioning-sleep" | "unavailable";
+    resource: "ai-gpu";
+    fingerprint: {
+        inferenceRuntimeDigest: string;
+        trainingRuntimeDigest: string;
+    } | null;
+    available: boolean;
+    activeTransition: {
+        schemaVersion: "treeseed.ai-mode-transition-receipt/v1";
+        state: "degraded" | "running" | "succeeded" | "planned" | "postponed" | "rolled-back";
+        resource: "ai-gpu";
+        completedAt: string | null;
+        idempotencyKey: string;
+        transitionId: string;
+        requestedBy: "operator" | "ai-lab";
+        from: "awake" | "sleep";
+        to: "awake" | "sleep";
+        reason: "active-inference" | "active-training" | "transition-failed" | "recovery-failed" | null;
+        fingerprint: {
+            inferenceRuntimeDigest: string;
+            trainingRuntimeDigest: string;
+        };
+        steps: {
+            id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+            state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+            completedAt: string | null;
+        }[];
+        startedAt: string;
+    } | null;
+    lastReceipt: {
+        schemaVersion: "treeseed.ai-mode-transition-receipt/v1";
+        state: "degraded" | "running" | "succeeded" | "planned" | "postponed" | "rolled-back";
+        resource: "ai-gpu";
+        completedAt: string | null;
+        idempotencyKey: string;
+        transitionId: string;
+        requestedBy: "operator" | "ai-lab";
+        from: "awake" | "sleep";
+        to: "awake" | "sleep";
+        reason: "active-inference" | "active-training" | "transition-failed" | "recovery-failed" | null;
+        fingerprint: {
+            inferenceRuntimeDigest: string;
+            trainingRuntimeDigest: string;
+        };
+        steps: {
+            id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+            state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+            completedAt: string | null;
+        }[];
+        startedAt: string;
+    } | null;
+}, {
+    schemaVersion: "treeseed.ai-mode-status/v1";
+    mode: "degraded" | "awake" | "sleep" | "transitioning-awake" | "transitioning-sleep" | "unavailable";
+    resource: "ai-gpu";
+    fingerprint: {
+        inferenceRuntimeDigest: string;
+        trainingRuntimeDigest: string;
+    } | null;
+    available: boolean;
+    activeTransition: {
+        schemaVersion: "treeseed.ai-mode-transition-receipt/v1";
+        state: "degraded" | "running" | "succeeded" | "planned" | "postponed" | "rolled-back";
+        resource: "ai-gpu";
+        completedAt: string | null;
+        idempotencyKey: string;
+        transitionId: string;
+        requestedBy: "operator" | "ai-lab";
+        from: "awake" | "sleep";
+        to: "awake" | "sleep";
+        reason: "active-inference" | "active-training" | "transition-failed" | "recovery-failed" | null;
+        fingerprint: {
+            inferenceRuntimeDigest: string;
+            trainingRuntimeDigest: string;
+        };
+        steps: {
+            id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+            state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+            completedAt: string | null;
+        }[];
+        startedAt: string;
+    } | null;
+    lastReceipt: {
+        schemaVersion: "treeseed.ai-mode-transition-receipt/v1";
+        state: "degraded" | "running" | "succeeded" | "planned" | "postponed" | "rolled-back";
+        resource: "ai-gpu";
+        completedAt: string | null;
+        idempotencyKey: string;
+        transitionId: string;
+        requestedBy: "operator" | "ai-lab";
+        from: "awake" | "sleep";
+        to: "awake" | "sleep";
+        reason: "active-inference" | "active-training" | "transition-failed" | "recovery-failed" | null;
+        fingerprint: {
+            inferenceRuntimeDigest: string;
+            trainingRuntimeDigest: string;
+        };
+        steps: {
+            id: "close-inference" | "drain-inference" | "stop-vllm" | "start-training" | "open-training" | "close-training" | "drain-training" | "stop-training" | "start-vllm" | "warm-vllm" | "open-inference" | "rollback";
+            state: "pending" | "failed" | "running" | "succeeded" | "skipped";
+            completedAt: string | null;
+        }[];
+        startedAt: string;
+    } | null;
+}>;
+export declare const aiModeInternalControlSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"treeseed.ai-mode-internal-control/v1">;
+    transport: z.ZodLiteral<"mtls">;
+    clientCommonName: z.ZodLiteral<"client-ai-lab-mode">;
+    method: z.ZodLiteral<"POST">;
+    path: z.ZodLiteral<string>;
+    urlEnvironment: z.ZodLiteral<"TREESEED_AI_MODE_URL">;
+    credentialFiles: z.ZodObject<{
+        certificateAuthority: z.ZodLiteral<"/run/secrets/ai-mode-ca">;
+        certificate: z.ZodLiteral<"/run/secrets/ai-mode-client-cert">;
+        privateKey: z.ZodLiteral<"/run/secrets/ai-mode-client-key">;
+    }, "strict", z.ZodTypeAny, {
+        certificateAuthority: "/run/secrets/ai-mode-ca";
+        certificate: "/run/secrets/ai-mode-client-cert";
+        privateKey: "/run/secrets/ai-mode-client-key";
+    }, {
+        certificateAuthority: "/run/secrets/ai-mode-ca";
+        certificate: "/run/secrets/ai-mode-client-cert";
+        privateKey: "/run/secrets/ai-mode-client-key";
+    }>;
+    requestSchema: z.ZodLiteral<"treeseed.ai-mode-request/v1">;
+    receiptSchema: z.ZodLiteral<"treeseed.ai-mode-transition-receipt/v1">;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    schemaVersion: "treeseed.ai-mode-internal-control/v1";
+    transport: "mtls";
+    clientCommonName: "client-ai-lab-mode";
+    method: "POST";
+    urlEnvironment: "TREESEED_AI_MODE_URL";
+    credentialFiles: {
+        certificateAuthority: "/run/secrets/ai-mode-ca";
+        certificate: "/run/secrets/ai-mode-client-cert";
+        privateKey: "/run/secrets/ai-mode-client-key";
+    };
+    requestSchema: "treeseed.ai-mode-request/v1";
+    receiptSchema: "treeseed.ai-mode-transition-receipt/v1";
+}, {
+    path: string;
+    schemaVersion: "treeseed.ai-mode-internal-control/v1";
+    transport: "mtls";
+    clientCommonName: "client-ai-lab-mode";
+    method: "POST";
+    urlEnvironment: "TREESEED_AI_MODE_URL";
+    credentialFiles: {
+        certificateAuthority: "/run/secrets/ai-mode-ca";
+        certificate: "/run/secrets/ai-mode-client-cert";
+        privateKey: "/run/secrets/ai-mode-client-key";
+    };
+    requestSchema: "treeseed.ai-mode-request/v1";
+    receiptSchema: "treeseed.ai-mode-transition-receipt/v1";
+}>;
+export type AiModeRequest = z.infer<typeof aiModeRequestSchema>;
+export type AiModeTransitionReceipt = z.infer<typeof aiModeTransitionReceiptSchema>;
+export type AiModeStatus = z.infer<typeof aiModeStatusSchema>;

package/dist/deployment/ai-mode.js

@@ -0,0 +1,67 @@
+import { z } from "zod";
+const AI_MODE_INTERNAL_PATH = `${["", "v1"].join("/")}/ai/mode`;
+const aiModeSchema = z.enum(["awake", "sleep"]);
+const aiModeFingerprintSchema = z.object({
+  inferenceRuntimeDigest: z.string().regex(/^sha256:[a-f0-9]{64}$/u),
+  trainingRuntimeDigest: z.string().regex(/^sha256:[a-f0-9]{64}$/u)
+}).strict();
+const aiModeRequestSchema = z.object({
+  schemaVersion: z.literal("treeseed.ai-mode-request/v1"),
+  target: aiModeSchema,
+  idempotencyKey: z.string().min(1).max(128).regex(/^[A-Za-z0-9._:-]+$/u),
+  drainTimeoutSeconds: z.number().int().min(1).max(3600).default(900)
+}).strict();
+const aiModeTransitionStepSchema = z.object({
+  id: z.enum(["close-inference", "drain-inference", "stop-vllm", "start-training", "open-training", "close-training", "drain-training", "stop-training", "start-vllm", "warm-vllm", "open-inference", "rollback"]),
+  state: z.enum(["pending", "running", "succeeded", "skipped", "failed"]),
+  completedAt: z.string().datetime().nullable()
+}).strict();
+const aiModeTransitionReceiptSchema = z.object({
+  schemaVersion: z.literal("treeseed.ai-mode-transition-receipt/v1"),
+  transitionId: z.string().uuid(),
+  idempotencyKey: z.string().min(1).max(128),
+  resource: z.literal("ai-gpu"),
+  requestedBy: z.enum(["operator", "ai-lab"]),
+  from: aiModeSchema,
+  to: aiModeSchema,
+  state: z.enum(["planned", "running", "succeeded", "postponed", "rolled-back", "degraded"]),
+  reason: z.enum(["active-inference", "active-training", "transition-failed", "recovery-failed"]).nullable(),
+  fingerprint: aiModeFingerprintSchema,
+  steps: z.array(aiModeTransitionStepSchema),
+  startedAt: z.string().datetime(),
+  completedAt: z.string().datetime().nullable()
+}).strict();
+const aiModeStatusSchema = z.object({
+  schemaVersion: z.literal("treeseed.ai-mode-status/v1"),
+  resource: z.literal("ai-gpu"),
+  available: z.boolean(),
+  mode: z.enum(["awake", "sleep", "transitioning-awake", "transitioning-sleep", "degraded", "unavailable"]),
+  fingerprint: aiModeFingerprintSchema.nullable(),
+  activeTransition: aiModeTransitionReceiptSchema.nullable(),
+  lastReceipt: aiModeTransitionReceiptSchema.nullable()
+}).strict();
+const aiModeInternalControlSchema = z.object({
+  schemaVersion: z.literal("treeseed.ai-mode-internal-control/v1"),
+  transport: z.literal("mtls"),
+  clientCommonName: z.literal("client-ai-lab-mode"),
+  method: z.literal("POST"),
+  path: z.literal(AI_MODE_INTERNAL_PATH),
+  urlEnvironment: z.literal("TREESEED_AI_MODE_URL"),
+  credentialFiles: z.object({
+    certificateAuthority: z.literal("/run/secrets/ai-mode-ca"),
+    certificate: z.literal("/run/secrets/ai-mode-client-cert"),
+    privateKey: z.literal("/run/secrets/ai-mode-client-key")
+  }).strict(),
+  requestSchema: z.literal("treeseed.ai-mode-request/v1"),
+  receiptSchema: z.literal("treeseed.ai-mode-transition-receipt/v1")
+}).strict();
+export {
+  AI_MODE_INTERNAL_PATH,
+  aiModeFingerprintSchema,
+  aiModeInternalControlSchema,
+  aiModeRequestSchema,
+  aiModeSchema,
+  aiModeStatusSchema,
+  aiModeTransitionReceiptSchema,
+  aiModeTransitionStepSchema
+};

package/dist/deployment/index.d.ts

@@ -2,3 +2,4 @@ export * from './schemas.js';
 export * from './canonical.js';
 export * from './catalog.js';
 export * from './topology.js';
+export * from './ai-mode.js';

package/dist/deployment/index.js

@@ -2,3 +2,4 @@ export * from "./schemas.js";
 export * from "./canonical.js";
 export * from "./catalog.js";
 export * from "./topology.js";
+export * from "./ai-mode.js";