File size: 2,386 Bytes
7b8fb69 ff57871 7b8fb69 ff57871 7b8fb69 ff57871 7b8fb69 ff57871 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 | import { z } from "zod";
/** Path embedded in every deployed Space image and checked by Hugging Face Jobs. */
export const DEPLOYMENT_MANIFEST_PATH = ".xtap-deployment.json";
const GIT_REVISION = /^[0-9a-f]{40}$/u;
const PLAN_WORKER_REVISION = /^[0-9a-f]{40,64}$/u;
const SHA256 = /^[0-9a-f]{64}$/u;
const SAFE_ID = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u;
export const enrichmentRevisionHandoffSchema = z
.object({
active_generation: z.number().int().positive(),
activation_sha256: z.string().regex(SHA256),
run_id: z.string().regex(SAFE_ID),
plan_sha256: z.string().regex(SHA256),
plan_worker_revision: z.string().regex(PLAN_WORKER_REVISION),
target_worker_revision: z.string().regex(GIT_REVISION),
contract_sha256: z.string().regex(SHA256),
source_snapshot_revision: z.string().regex(SHA256),
checkpoint_pointer_sha256: z.string().regex(SHA256),
checkpoint_sequence: z.number().int().positive(),
checkpoint_key: z.string().min(1),
checkpoint_sha256: z.string().regex(SHA256),
checkpoint_bytes: z.number().int().positive(),
})
.strict()
.superRefine((handoff, context) => {
if (handoff.plan_worker_revision === handoff.target_worker_revision) {
context.addIssue({
code: "custom",
path: ["target_worker_revision"],
message: "revision handoff target must differ from the planned worker revision",
});
}
});
export type EnrichmentRevisionHandoff = z.infer<typeof enrichmentRevisionHandoffSchema>;
export const deploymentManifestSchema = z
.object({
source_revision: z.string().regex(GIT_REVISION),
enrichment_revision_handoff: enrichmentRevisionHandoffSchema.nullable(),
})
.strict()
.superRefine((manifest, context) => {
const target = manifest.enrichment_revision_handoff?.target_worker_revision;
if (target !== undefined && target !== manifest.source_revision) {
context.addIssue({
code: "custom",
path: ["enrichment_revision_handoff", "target_worker_revision"],
message: "revision handoff target must equal the deployment source revision",
});
}
});
export type DeploymentManifest = z.infer<typeof deploymentManifestSchema>;
export function serializeDeploymentManifest(value: unknown): string {
const manifest = deploymentManifestSchema.parse(value);
return `${JSON.stringify(manifest, null, 2)}\n`;
}
|