The best way to control Claude Code, Codex and more from any computer or phone
| 1 | import type { FlyMachineConfig } from "@distilled.cloud/fly-io/machines"; |
| 2 | import * as Option from "effect/Option"; |
| 3 | import * as Schema from "effect/Schema"; |
| 4 | import { alchemyMetadataKeys as keys } from "./Metadata.ts"; |
| 5 | |
| 6 | const ImageSet = Schema.Array(Schema.Struct({ name: Schema.String, image: Schema.String })); |
| 7 | export type ContainerImagePin = { name: string; image: string }; |
| 8 | |
| 9 | /** Blue/green needs immutable image references that survive a crash. */ |
| 10 | export const isImmutableImage = (image: string): boolean => |
| 11 | /^[a-zA-Z0-9][a-zA-Z0-9._:/-]*@sha256:[a-fA-F0-9]{64}$/.test(image); |
| 12 | |
| 13 | const canonical = (pins: readonly ContainerImagePin[]): ContainerImagePin[] => |
| 14 | [...pins].sort((a, b) => a.name.localeCompare(b.name)); |
| 15 | |
| 16 | const valid = (pins: readonly ContainerImagePin[]): boolean => |
| 17 | pins.length > 0 && |
| 18 | new Set(pins.map(({ name }) => name)).size === pins.length && |
| 19 | pins.every(({ name, image }) => name.trim().length > 0 && isImmutableImage(image)); |
| 20 | |
| 21 | export const pinsFromConfig = ( |
| 22 | config: FlyMachineConfig | undefined, |
| 23 | ): ContainerImagePin[] | undefined => { |
| 24 | const containers = config?.containers; |
| 25 | if (!containers?.length) return undefined; |
| 26 | const pins = containers.map(({ name, image }) => ({ |
| 27 | name: name ?? "", |
| 28 | image: image ?? "", |
| 29 | })); |
| 30 | return valid(pins) ? canonical(pins) : undefined; |
| 31 | }; |
| 32 | |
| 33 | export const encodeImageSet = (pins: readonly ContainerImagePin[]): string | undefined => |
| 34 | valid(pins) ? JSON.stringify(canonical(pins)) : undefined; |
| 35 | |
| 36 | export const decodeImageSet = (raw: string | undefined): ContainerImagePin[] | undefined => { |
| 37 | if (raw === undefined) return undefined; |
| 38 | const decoded = Schema.decodeOption(Schema.fromJsonString(ImageSet))(raw); |
| 39 | if (!Option.isSome(decoded)) return undefined; |
| 40 | const pins = decoded.value; |
| 41 | return valid(pins) ? canonical(pins) : undefined; |
| 42 | }; |
| 43 | |
| 44 | export const sameImageSet = ( |
| 45 | left: readonly ContainerImagePin[] | undefined, |
| 46 | right: readonly ContainerImagePin[] | undefined, |
| 47 | ): boolean => { |
| 48 | const a = left === undefined ? undefined : encodeImageSet(left); |
| 49 | const b = right === undefined ? undefined : encodeImageSet(right); |
| 50 | return a !== undefined && b !== undefined && a === b; |
| 51 | }; |
| 52 | |
| 53 | /** Protocol-2 metadata and the authoritative readback config must describe exactly the same set. */ |
| 54 | export const validObservedImageSet = (machine: { config?: FlyMachineConfig }): boolean => { |
| 55 | const metadata = machine.config?.metadata; |
| 56 | if (metadata?.[keys.protocol] !== "2" || metadata[keys.image] !== undefined) return false; |
| 57 | return sameImageSet( |
| 58 | decodeImageSet(metadata[keys.containerImageSet]), |
| 59 | pinsFromConfig(machine.config), |
| 60 | ); |
| 61 | }; |
| 62 | |
| 63 | /** Keep all named pins when changing service or idle policy on a candidate. */ |
| 64 | export const applyImageSet = ( |
| 65 | config: FlyMachineConfig, |
| 66 | pins: readonly ContainerImagePin[], |
| 67 | ): FlyMachineConfig | undefined => { |
| 68 | if (!valid(pins) || !config.containers) return undefined; |
| 69 | const byName = new Map(pins.map((pin) => [pin.name, pin.image])); |
| 70 | if ( |
| 71 | config.containers.length !== byName.size || |
| 72 | new Set(config.containers.map(({ name }) => name)).size !== config.containers.length || |
| 73 | config.containers.some(({ name }) => name === undefined || !byName.has(name)) |
| 74 | ) |
| 75 | return undefined; |
| 76 | return { |
| 77 | ...config, |
| 78 | image: undefined, |
| 79 | containers: config.containers.map((container) => ({ |
| 80 | ...container, |
| 81 | image: byName.get(container.name!), |
| 82 | })), |
| 83 | }; |
| 84 | }; |