@claudexor/schema 5.0.2 → 6.0.0

package/dist/harness-program.d.ts

@@ -0,0 +1,2164 @@
+import { z } from "zod/v3";
+/** Templates substitute {program}, {version}, {home}, {localAppData}, {arch}.
+ * They are argv/environment values, never shell source. */
+export declare const HarnessProgramCommand: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"exec">;
+    command: z.ZodString;
+    args: z.ZodArray<z.ZodString, "many">;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strict", z.ZodTypeAny, {
+    kind: "exec";
+    command: string;
+    args: string[];
+    env?: Record<string, string> | undefined;
+}, {
+    kind: "exec";
+    command: string;
+    args: string[];
+    env?: Record<string, string> | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"script">;
+    url: z.ZodString;
+    interpreter: z.ZodString;
+    interpreterArgs: z.ZodArray<z.ZodString, "many">;
+    args: z.ZodArray<z.ZodString, "many">;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strict", z.ZodTypeAny, {
+    kind: "script";
+    url: string;
+    interpreter: string;
+    interpreterArgs: string[];
+    args: string[];
+    env?: Record<string, string> | undefined;
+}, {
+    kind: "script";
+    url: string;
+    interpreter: string;
+    interpreterArgs: string[];
+    args: string[];
+    env?: Record<string, string> | undefined;
+}>]>;
+export type HarnessProgramCommand = z.infer<typeof HarnessProgramCommand>;
+export declare const HarnessNewestSource: z.ZodObject<{
+    url: z.ZodString;
+    pick: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"text">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "text";
+    }, {
+        kind: "text";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"json">;
+        field: z.ZodString;
+        stripPrefix: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "json";
+        field: string;
+        stripPrefix?: string | undefined;
+    }, {
+        kind: "json";
+        field: string;
+        stripPrefix?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"pattern">;
+        pattern: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "pattern";
+        pattern: string;
+    }, {
+        kind: "pattern";
+        pattern: string;
+    }>]>;
+}, "strict", z.ZodTypeAny, {
+    url: string;
+    pick: {
+        kind: "text";
+    } | {
+        kind: "json";
+        field: string;
+        stripPrefix?: string | undefined;
+    } | {
+        kind: "pattern";
+        pattern: string;
+    };
+}, {
+    url: string;
+    pick: {
+        kind: "text";
+    } | {
+        kind: "json";
+        field: string;
+        stripPrefix?: string | undefined;
+    } | {
+        kind: "pattern";
+        pattern: string;
+    };
+}>;
+export type HarnessNewestSource = z.infer<typeof HarnessNewestSource>;
+export declare const HarnessProgramPlatform: z.ZodObject<{
+    /** Folder templates may use {env:NAME}; absent vendor inputs omit that folder. */
+    launcherDirs: z.ZodArray<z.ZodString, "many">;
+    install: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"exec">;
+        command: z.ZodString;
+        args: z.ZodArray<z.ZodString, "many">;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "exec";
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    }, {
+        kind: "exec";
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"script">;
+        url: z.ZodString;
+        interpreter: z.ZodString;
+        interpreterArgs: z.ZodArray<z.ZodString, "many">;
+        args: z.ZodArray<z.ZodString, "many">;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "script";
+        url: string;
+        interpreter: string;
+        interpreterArgs: string[];
+        args: string[];
+        env?: Record<string, string> | undefined;
+    }, {
+        kind: "script";
+        url: string;
+        interpreter: string;
+        interpreterArgs: string[];
+        args: string[];
+        env?: Record<string, string> | undefined;
+    }>]>>;
+    update: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"exec">;
+        command: z.ZodString;
+        args: z.ZodArray<z.ZodString, "many">;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "exec";
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    }, {
+        kind: "exec";
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"script">;
+        url: z.ZodString;
+        interpreter: z.ZodString;
+        interpreterArgs: z.ZodArray<z.ZodString, "many">;
+        args: z.ZodArray<z.ZodString, "many">;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "script";
+        url: string;
+        interpreter: string;
+        interpreterArgs: string[];
+        args: string[];
+        env?: Record<string, string> | undefined;
+    }, {
+        kind: "script";
+        url: string;
+        interpreter: string;
+        interpreterArgs: string[];
+        args: string[];
+        env?: Record<string, string> | undefined;
+    }>]>>;
+    exactVersion: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"exec">;
+        command: z.ZodString;
+        args: z.ZodArray<z.ZodString, "many">;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "exec";
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    }, {
+        kind: "exec";
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"script">;
+        url: z.ZodString;
+        interpreter: z.ZodString;
+        interpreterArgs: z.ZodArray<z.ZodString, "many">;
+        args: z.ZodArray<z.ZodString, "many">;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "script";
+        url: string;
+        interpreter: string;
+        interpreterArgs: string[];
+        args: string[];
+        env?: Record<string, string> | undefined;
+    }, {
+        kind: "script";
+        url: string;
+        interpreter: string;
+        interpreterArgs: string[];
+        args: string[];
+        env?: Record<string, string> | undefined;
+    }>]>>;
+    newest: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        pick: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"text">;
+        }, "strict", z.ZodTypeAny, {
+            kind: "text";
+        }, {
+            kind: "text";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"json">;
+            field: z.ZodString;
+            stripPrefix: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "json";
+            field: string;
+            stripPrefix?: string | undefined;
+        }, {
+            kind: "json";
+            field: string;
+            stripPrefix?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"pattern">;
+            pattern: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "pattern";
+            pattern: string;
+        }, {
+            kind: "pattern";
+            pattern: string;
+        }>]>;
+    }, "strict", z.ZodTypeAny, {
+        url: string;
+        pick: {
+            kind: "text";
+        } | {
+            kind: "json";
+            field: string;
+            stripPrefix?: string | undefined;
+        } | {
+            kind: "pattern";
+            pattern: string;
+        };
+    }, {
+        url: string;
+        pick: {
+            kind: "text";
+        } | {
+            kind: "json";
+            field: string;
+            stripPrefix?: string | undefined;
+        } | {
+            kind: "pattern";
+            pattern: string;
+        };
+    }>>;
+    /** Vendor-specific architecture spelling in the newest URL. */
+    architectures: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    reasons: z.ZodOptional<z.ZodObject<{
+        install: z.ZodOptional<z.ZodString>;
+        update: z.ZodOptional<z.ZodString>;
+        exactVersion: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        install?: string | undefined;
+        update?: string | undefined;
+        exactVersion?: string | undefined;
+    }, {
+        install?: string | undefined;
+        update?: string | undefined;
+        exactVersion?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    launcherDirs: string[];
+    install?: {
+        kind: "exec";
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    } | {
+        kind: "script";
+        url: string;
+        interpreter: string;
+        interpreterArgs: string[];
+        args: string[];
+        env?: Record<string, string> | undefined;
+    } | undefined;
+    update?: {
+        kind: "exec";
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    } | {
+        kind: "script";
+        url: string;
+        interpreter: string;
+        interpreterArgs: string[];
+        args: string[];
+        env?: Record<string, string> | undefined;
+    } | undefined;
+    exactVersion?: {
+        kind: "exec";
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    } | {
+        kind: "script";
+        url: string;
+        interpreter: string;
+        interpreterArgs: string[];
+        args: string[];
+        env?: Record<string, string> | undefined;
+    } | undefined;
+    newest?: {
+        url: string;
+        pick: {
+            kind: "text";
+        } | {
+            kind: "json";
+            field: string;
+            stripPrefix?: string | undefined;
+        } | {
+            kind: "pattern";
+            pattern: string;
+        };
+    } | undefined;
+    architectures?: Record<string, string> | undefined;
+    reasons?: {
+        install?: string | undefined;
+        update?: string | undefined;
+        exactVersion?: string | undefined;
+    } | undefined;
+}, {
+    launcherDirs: string[];
+    install?: {
+        kind: "exec";
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    } | {
+        kind: "script";
+        url: string;
+        interpreter: string;
+        interpreterArgs: string[];
+        args: string[];
+        env?: Record<string, string> | undefined;
+    } | undefined;
+    update?: {
+        kind: "exec";
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    } | {
+        kind: "script";
+        url: string;
+        interpreter: string;
+        interpreterArgs: string[];
+        args: string[];
+        env?: Record<string, string> | undefined;
+    } | undefined;
+    exactVersion?: {
+        kind: "exec";
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    } | {
+        kind: "script";
+        url: string;
+        interpreter: string;
+        interpreterArgs: string[];
+        args: string[];
+        env?: Record<string, string> | undefined;
+    } | undefined;
+    newest?: {
+        url: string;
+        pick: {
+            kind: "text";
+        } | {
+            kind: "json";
+            field: string;
+            stripPrefix?: string | undefined;
+        } | {
+            kind: "pattern";
+            pattern: string;
+        };
+    } | undefined;
+    architectures?: Record<string, string> | undefined;
+    reasons?: {
+        install?: string | undefined;
+        update?: string | undefined;
+        exactVersion?: string | undefined;
+    } | undefined;
+}>;
+export type HarnessProgramPlatform = z.infer<typeof HarnessProgramPlatform>;
+/** Distribution facts live beside the adapter; no engine-owned install kind. */
+export declare const HarnessProgram: z.ZodObject<{
+    id: z.ZodString;
+    launchers: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        realPathPattern: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        realPathPattern?: string | undefined;
+    }, {
+        name: string;
+        realPathPattern?: string | undefined;
+    }>, "many">;
+    overrideEnv: z.ZodString;
+    /** Unrecognized formats are never ordered heuristically. */
+    versionScheme: z.ZodOptional<z.ZodEnum<["semver", "date-hash", "opaque"]>>;
+    releaseNotesUrl: z.ZodOptional<z.ZodString>;
+    platforms: z.ZodObject<{
+        darwin: z.ZodOptional<z.ZodObject<{
+            /** Folder templates may use {env:NAME}; absent vendor inputs omit that folder. */
+            launcherDirs: z.ZodArray<z.ZodString, "many">;
+            install: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"exec">;
+                command: z.ZodString;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"script">;
+                url: z.ZodString;
+                interpreter: z.ZodString;
+                interpreterArgs: z.ZodArray<z.ZodString, "many">;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>]>>;
+            update: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"exec">;
+                command: z.ZodString;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"script">;
+                url: z.ZodString;
+                interpreter: z.ZodString;
+                interpreterArgs: z.ZodArray<z.ZodString, "many">;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>]>>;
+            exactVersion: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"exec">;
+                command: z.ZodString;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"script">;
+                url: z.ZodString;
+                interpreter: z.ZodString;
+                interpreterArgs: z.ZodArray<z.ZodString, "many">;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>]>>;
+            newest: z.ZodOptional<z.ZodObject<{
+                url: z.ZodString;
+                pick: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                    kind: z.ZodLiteral<"text">;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "text";
+                }, {
+                    kind: "text";
+                }>, z.ZodObject<{
+                    kind: z.ZodLiteral<"json">;
+                    field: z.ZodString;
+                    stripPrefix: z.ZodOptional<z.ZodString>;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                }, {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                }>, z.ZodObject<{
+                    kind: z.ZodLiteral<"pattern">;
+                    pattern: z.ZodString;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "pattern";
+                    pattern: string;
+                }, {
+                    kind: "pattern";
+                    pattern: string;
+                }>]>;
+            }, "strict", z.ZodTypeAny, {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            }, {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            }>>;
+            /** Vendor-specific architecture spelling in the newest URL. */
+            architectures: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            reasons: z.ZodOptional<z.ZodObject<{
+                install: z.ZodOptional<z.ZodString>;
+                update: z.ZodOptional<z.ZodString>;
+                exactVersion: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            }, {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            }>>;
+        }, "strict", z.ZodTypeAny, {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        }, {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        }>>;
+        linux: z.ZodOptional<z.ZodObject<{
+            /** Folder templates may use {env:NAME}; absent vendor inputs omit that folder. */
+            launcherDirs: z.ZodArray<z.ZodString, "many">;
+            install: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"exec">;
+                command: z.ZodString;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"script">;
+                url: z.ZodString;
+                interpreter: z.ZodString;
+                interpreterArgs: z.ZodArray<z.ZodString, "many">;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>]>>;
+            update: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"exec">;
+                command: z.ZodString;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"script">;
+                url: z.ZodString;
+                interpreter: z.ZodString;
+                interpreterArgs: z.ZodArray<z.ZodString, "many">;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>]>>;
+            exactVersion: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"exec">;
+                command: z.ZodString;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"script">;
+                url: z.ZodString;
+                interpreter: z.ZodString;
+                interpreterArgs: z.ZodArray<z.ZodString, "many">;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>]>>;
+            newest: z.ZodOptional<z.ZodObject<{
+                url: z.ZodString;
+                pick: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                    kind: z.ZodLiteral<"text">;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "text";
+                }, {
+                    kind: "text";
+                }>, z.ZodObject<{
+                    kind: z.ZodLiteral<"json">;
+                    field: z.ZodString;
+                    stripPrefix: z.ZodOptional<z.ZodString>;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                }, {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                }>, z.ZodObject<{
+                    kind: z.ZodLiteral<"pattern">;
+                    pattern: z.ZodString;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "pattern";
+                    pattern: string;
+                }, {
+                    kind: "pattern";
+                    pattern: string;
+                }>]>;
+            }, "strict", z.ZodTypeAny, {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            }, {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            }>>;
+            /** Vendor-specific architecture spelling in the newest URL. */
+            architectures: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            reasons: z.ZodOptional<z.ZodObject<{
+                install: z.ZodOptional<z.ZodString>;
+                update: z.ZodOptional<z.ZodString>;
+                exactVersion: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            }, {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            }>>;
+        }, "strict", z.ZodTypeAny, {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        }, {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        }>>;
+        win32: z.ZodOptional<z.ZodObject<{
+            /** Folder templates may use {env:NAME}; absent vendor inputs omit that folder. */
+            launcherDirs: z.ZodArray<z.ZodString, "many">;
+            install: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"exec">;
+                command: z.ZodString;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"script">;
+                url: z.ZodString;
+                interpreter: z.ZodString;
+                interpreterArgs: z.ZodArray<z.ZodString, "many">;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>]>>;
+            update: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"exec">;
+                command: z.ZodString;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"script">;
+                url: z.ZodString;
+                interpreter: z.ZodString;
+                interpreterArgs: z.ZodArray<z.ZodString, "many">;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>]>>;
+            exactVersion: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"exec">;
+                command: z.ZodString;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"script">;
+                url: z.ZodString;
+                interpreter: z.ZodString;
+                interpreterArgs: z.ZodArray<z.ZodString, "many">;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>]>>;
+            newest: z.ZodOptional<z.ZodObject<{
+                url: z.ZodString;
+                pick: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                    kind: z.ZodLiteral<"text">;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "text";
+                }, {
+                    kind: "text";
+                }>, z.ZodObject<{
+                    kind: z.ZodLiteral<"json">;
+                    field: z.ZodString;
+                    stripPrefix: z.ZodOptional<z.ZodString>;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                }, {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                }>, z.ZodObject<{
+                    kind: z.ZodLiteral<"pattern">;
+                    pattern: z.ZodString;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "pattern";
+                    pattern: string;
+                }, {
+                    kind: "pattern";
+                    pattern: string;
+                }>]>;
+            }, "strict", z.ZodTypeAny, {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            }, {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            }>>;
+            /** Vendor-specific architecture spelling in the newest URL. */
+            architectures: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            reasons: z.ZodOptional<z.ZodObject<{
+                install: z.ZodOptional<z.ZodString>;
+                update: z.ZodOptional<z.ZodString>;
+                exactVersion: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            }, {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            }>>;
+        }, "strict", z.ZodTypeAny, {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        }, {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        darwin?: {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        } | undefined;
+        linux?: {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        } | undefined;
+        win32?: {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        } | undefined;
+    }, {
+        darwin?: {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        } | undefined;
+        linux?: {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        } | undefined;
+        win32?: {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        } | undefined;
+    }>;
+    installationEnv: z.ZodArray<z.ZodString, "many">;
+    /** Only proves conversion of copies older engines made. Never an install target. */
+    legacyNpmPackage: z.ZodOptional<z.ZodString>;
+    /** A vendor-supported line boundary, e.g. OpenCode's V1 driver. */
+    majorVersion: z.ZodOptional<z.ZodNumber>;
+    childUpdateEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    childUpdateArgs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    launchers: {
+        name: string;
+        realPathPattern?: string | undefined;
+    }[];
+    overrideEnv: string;
+    versionScheme?: "date-hash" | "opaque" | "semver" | undefined;
+    releaseNotesUrl?: string | undefined;
+    platforms: {
+        darwin?: {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        } | undefined;
+        linux?: {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        } | undefined;
+        win32?: {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        } | undefined;
+    };
+    installationEnv: string[];
+    legacyNpmPackage?: string | undefined;
+    majorVersion?: number | undefined;
+    childUpdateEnv?: Record<string, string> | undefined;
+    childUpdateArgs?: string[] | undefined;
+}, {
+    id: string;
+    launchers: {
+        name: string;
+        realPathPattern?: string | undefined;
+    }[];
+    overrideEnv: string;
+    versionScheme?: "date-hash" | "opaque" | "semver" | undefined;
+    releaseNotesUrl?: string | undefined;
+    platforms: {
+        darwin?: {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        } | undefined;
+        linux?: {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        } | undefined;
+        win32?: {
+            launcherDirs: string[];
+            install?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            update?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            exactVersion?: {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | undefined;
+            newest?: {
+                url: string;
+                pick: {
+                    kind: "text";
+                } | {
+                    kind: "json";
+                    field: string;
+                    stripPrefix?: string | undefined;
+                } | {
+                    kind: "pattern";
+                    pattern: string;
+                };
+            } | undefined;
+            architectures?: Record<string, string> | undefined;
+            reasons?: {
+                install?: string | undefined;
+                update?: string | undefined;
+                exactVersion?: string | undefined;
+            } | undefined;
+        } | undefined;
+    };
+    installationEnv: string[];
+    legacyNpmPackage?: string | undefined;
+    majorVersion?: number | undefined;
+    childUpdateEnv?: Record<string, string> | undefined;
+    childUpdateArgs?: string[] | undefined;
+}>;
+export type HarnessProgram = z.infer<typeof HarnessProgram>;
+/** One observation of exactly the invocation the resolver selected. */
+export declare const SelectedHarnessProgram: z.ZodObject<{
+    path: z.ZodNullable<z.ZodString>;
+    realPath: z.ZodNullable<z.ZodString>;
+    version: z.ZodNullable<z.ZodString>;
+    versionOutput: z.ZodNullable<z.ZodString>;
+    overrideEnv: z.ZodNullable<z.ZodString>;
+    overrideValue: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    path: string | null;
+    realPath: string | null;
+    version: string | null;
+    versionOutput: string | null;
+    overrideEnv: string | null;
+    overrideValue: string | null;
+}, {
+    path: string | null;
+    realPath: string | null;
+    version: string | null;
+    versionOutput: string | null;
+    overrideEnv: string | null;
+    overrideValue: string | null;
+}>;
+export type SelectedHarnessProgram = z.infer<typeof SelectedHarnessProgram>;
+/** Public provenance of a program-derived answer. Null version means the program did not answer. */
+export declare const HarnessProgramIdentity: z.ZodObject<{
+    path: z.ZodString;
+    version: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    version: string | null;
+}, {
+    path: string;
+    version: string | null;
+}>;
+export type HarnessProgramIdentity = z.infer<typeof HarnessProgramIdentity>;
+/** Native execution provenance. A vendor startup answer outranks a pre-spawn version read. */
+export declare const NativeProgramEvidence: z.ZodObject<{
+    path: z.ZodNullable<z.ZodString>;
+    version: z.ZodNullable<z.ZodString>;
+    versionSource: z.ZodEnum<["vendor_stream", "version_probe", "remembered", "unknown"]>;
+}, "strict", z.ZodTypeAny, {
+    path: string | null;
+    version: string | null;
+    versionSource: "remembered" | "unknown" | "vendor_stream" | "version_probe";
+}, {
+    path: string | null;
+    version: string | null;
+    versionSource: "remembered" | "unknown" | "vendor_stream" | "version_probe";
+}>;
+export type NativeProgramEvidence = z.infer<typeof NativeProgramEvidence>;
+//# sourceMappingURL=harness-program.d.ts.map