@claudexor/schema 3.23.2 → 3.25.1

package/dist/harness-maintenance.d.ts

@@ -0,0 +1,938 @@
+import { z } from "zod/v3";
+/** One exact vendor registry version (no range, tag or `v` prefix). */
+export declare const HarnessVendorVersion: z.ZodString;
+export declare const HarnessMaintenanceTarget: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"latest">;
+}, "strict", z.ZodTypeAny, {
+    kind: "latest";
+}, {
+    kind: "latest";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"version">;
+    version: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    kind: "version";
+    version: string;
+}, {
+    kind: "version";
+    version: string;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"previous">;
+}, "strict", z.ZodTypeAny, {
+    kind: "previous";
+}, {
+    kind: "previous";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"baseline">;
+}, "strict", z.ZodTypeAny, {
+    kind: "baseline";
+}, {
+    kind: "baseline";
+}>]>;
+export type HarnessMaintenanceTarget = z.infer<typeof HarnessMaintenanceTarget>;
+export declare const HarnessMaintenanceEntry: z.ZodObject<{
+    harness: z.ZodString;
+    mechanism: z.ZodEnum<["managed_npm", "vendor_updater", "vendor_script"]>;
+    maintainable: z.ZodBoolean;
+    canCheckLatest: z.ZodBoolean;
+    targets: z.ZodArray<z.ZodEnum<["latest", "version", "previous", "baseline"]>, "many">;
+    remedy: z.ZodNullable<z.ZodString>;
+    selection: z.ZodObject<{
+        kind: z.ZodEnum<["managed", "override", "path", "missing"]>;
+        binary: z.ZodNullable<z.ZodString>;
+        version: z.ZodNullable<z.ZodString>;
+        overrideEnv: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "managed" | "missing" | "override" | "path";
+        binary: string | null;
+        version: string | null;
+        overrideEnv: string | null;
+    }, {
+        kind: "managed" | "missing" | "override" | "path";
+        binary: string | null;
+        version: string | null;
+        overrideEnv: string | null;
+    }>;
+    installed: z.ZodObject<{
+        version: z.ZodNullable<z.ZodString>;
+        binary: z.ZodNullable<z.ZodString>;
+        proved: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        version: string | null;
+        binary: string | null;
+        proved: boolean;
+    }, {
+        version: string | null;
+        binary: string | null;
+        proved: boolean;
+    }>;
+    releaseTested: z.ZodObject<{
+        version: z.ZodNullable<z.ZodString>;
+        verification: z.ZodNullable<z.ZodEnum<["release_verified", "deterministic_only"]>>;
+    }, "strict", z.ZodTypeAny, {
+        version: string | null;
+        verification: "deterministic_only" | "release_verified" | null;
+    }, {
+        version: string | null;
+        verification: "deterministic_only" | "release_verified" | null;
+    }>;
+    available: z.ZodNullable<z.ZodObject<{
+        version: z.ZodString;
+        observedAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        version: string;
+        observedAt: string;
+    }, {
+        version: string;
+        observedAt: string;
+    }>>;
+    availableProblem: z.ZodNullable<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        retryable: z.ZodBoolean;
+        fieldErrors: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+        requiredActions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strict", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors: Record<string, string[]>;
+        requiredActions: string[];
+        evidenceRefs: string[];
+        context: Record<string, unknown>;
+    }, {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors?: Record<string, string[]> | undefined;
+        requiredActions?: string[] | undefined;
+        evidenceRefs?: string[] | undefined;
+        context?: Record<string, unknown> | undefined;
+    }>>;
+    previous: z.ZodNullable<z.ZodObject<{
+        version: z.ZodString;
+        operationId: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        version: string;
+        operationId: string;
+    }, {
+        version: string;
+        operationId: string;
+    }>>;
+    operation: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        state: z.ZodString;
+        phase: z.ZodString;
+        targetVersion: z.ZodNullable<z.ZodString>;
+        finishedAt: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        state: string;
+        phase: string;
+        targetVersion: string | null;
+        finishedAt: string | null;
+    }, {
+        id: string;
+        state: string;
+        phase: string;
+        targetVersion: string | null;
+        finishedAt: string | null;
+    }>>;
+    observedAt: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    harness: string;
+    mechanism: "managed_npm" | "vendor_script" | "vendor_updater";
+    maintainable: boolean;
+    canCheckLatest: boolean;
+    targets: ("baseline" | "latest" | "previous" | "version")[];
+    remedy: string | null;
+    selection: {
+        kind: "managed" | "missing" | "override" | "path";
+        binary: string | null;
+        version: string | null;
+        overrideEnv: string | null;
+    };
+    installed: {
+        version: string | null;
+        binary: string | null;
+        proved: boolean;
+    };
+    releaseTested: {
+        version: string | null;
+        verification: "deterministic_only" | "release_verified" | null;
+    };
+    available: {
+        version: string;
+        observedAt: string;
+    } | null;
+    availableProblem: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors: Record<string, string[]>;
+        requiredActions: string[];
+        evidenceRefs: string[];
+        context: Record<string, unknown>;
+    } | null;
+    previous: {
+        version: string;
+        operationId: string;
+    } | null;
+    operation: {
+        id: string;
+        state: string;
+        phase: string;
+        targetVersion: string | null;
+        finishedAt: string | null;
+    } | null;
+    observedAt: string;
+}, {
+    harness: string;
+    mechanism: "managed_npm" | "vendor_script" | "vendor_updater";
+    maintainable: boolean;
+    canCheckLatest: boolean;
+    targets: ("baseline" | "latest" | "previous" | "version")[];
+    remedy: string | null;
+    selection: {
+        kind: "managed" | "missing" | "override" | "path";
+        binary: string | null;
+        version: string | null;
+        overrideEnv: string | null;
+    };
+    installed: {
+        version: string | null;
+        binary: string | null;
+        proved: boolean;
+    };
+    releaseTested: {
+        version: string | null;
+        verification: "deterministic_only" | "release_verified" | null;
+    };
+    available: {
+        version: string;
+        observedAt: string;
+    } | null;
+    availableProblem: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors?: Record<string, string[]> | undefined;
+        requiredActions?: string[] | undefined;
+        evidenceRefs?: string[] | undefined;
+        context?: Record<string, unknown> | undefined;
+    } | null;
+    previous: {
+        version: string;
+        operationId: string;
+    } | null;
+    operation: {
+        id: string;
+        state: string;
+        phase: string;
+        targetVersion: string | null;
+        finishedAt: string | null;
+    } | null;
+    observedAt: string;
+}>;
+export type HarnessMaintenanceEntry = z.infer<typeof HarnessMaintenanceEntry>;
+export declare const ControlHarnessMaintenanceInventory: z.ZodObject<{
+    observedAt: z.ZodString;
+    harnesses: z.ZodArray<z.ZodObject<{
+        harness: z.ZodString;
+        mechanism: z.ZodEnum<["managed_npm", "vendor_updater", "vendor_script"]>;
+        maintainable: z.ZodBoolean;
+        canCheckLatest: z.ZodBoolean;
+        targets: z.ZodArray<z.ZodEnum<["latest", "version", "previous", "baseline"]>, "many">;
+        remedy: z.ZodNullable<z.ZodString>;
+        selection: z.ZodObject<{
+            kind: z.ZodEnum<["managed", "override", "path", "missing"]>;
+            binary: z.ZodNullable<z.ZodString>;
+            version: z.ZodNullable<z.ZodString>;
+            overrideEnv: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "managed" | "missing" | "override" | "path";
+            binary: string | null;
+            version: string | null;
+            overrideEnv: string | null;
+        }, {
+            kind: "managed" | "missing" | "override" | "path";
+            binary: string | null;
+            version: string | null;
+            overrideEnv: string | null;
+        }>;
+        installed: z.ZodObject<{
+            version: z.ZodNullable<z.ZodString>;
+            binary: z.ZodNullable<z.ZodString>;
+            proved: z.ZodBoolean;
+        }, "strict", z.ZodTypeAny, {
+            version: string | null;
+            binary: string | null;
+            proved: boolean;
+        }, {
+            version: string | null;
+            binary: string | null;
+            proved: boolean;
+        }>;
+        releaseTested: z.ZodObject<{
+            version: z.ZodNullable<z.ZodString>;
+            verification: z.ZodNullable<z.ZodEnum<["release_verified", "deterministic_only"]>>;
+        }, "strict", z.ZodTypeAny, {
+            version: string | null;
+            verification: "deterministic_only" | "release_verified" | null;
+        }, {
+            version: string | null;
+            verification: "deterministic_only" | "release_verified" | null;
+        }>;
+        available: z.ZodNullable<z.ZodObject<{
+            version: z.ZodString;
+            observedAt: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            version: string;
+            observedAt: string;
+        }, {
+            version: string;
+            observedAt: string;
+        }>>;
+        availableProblem: z.ZodNullable<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            retryable: z.ZodBoolean;
+            fieldErrors: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+            requiredActions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strict", z.ZodTypeAny, {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors: Record<string, string[]>;
+            requiredActions: string[];
+            evidenceRefs: string[];
+            context: Record<string, unknown>;
+        }, {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors?: Record<string, string[]> | undefined;
+            requiredActions?: string[] | undefined;
+            evidenceRefs?: string[] | undefined;
+            context?: Record<string, unknown> | undefined;
+        }>>;
+        previous: z.ZodNullable<z.ZodObject<{
+            version: z.ZodString;
+            operationId: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            version: string;
+            operationId: string;
+        }, {
+            version: string;
+            operationId: string;
+        }>>;
+        operation: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            state: z.ZodString;
+            phase: z.ZodString;
+            targetVersion: z.ZodNullable<z.ZodString>;
+            finishedAt: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            state: string;
+            phase: string;
+            targetVersion: string | null;
+            finishedAt: string | null;
+        }, {
+            id: string;
+            state: string;
+            phase: string;
+            targetVersion: string | null;
+            finishedAt: string | null;
+        }>>;
+        observedAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        harness: string;
+        mechanism: "managed_npm" | "vendor_script" | "vendor_updater";
+        maintainable: boolean;
+        canCheckLatest: boolean;
+        targets: ("baseline" | "latest" | "previous" | "version")[];
+        remedy: string | null;
+        selection: {
+            kind: "managed" | "missing" | "override" | "path";
+            binary: string | null;
+            version: string | null;
+            overrideEnv: string | null;
+        };
+        installed: {
+            version: string | null;
+            binary: string | null;
+            proved: boolean;
+        };
+        releaseTested: {
+            version: string | null;
+            verification: "deterministic_only" | "release_verified" | null;
+        };
+        available: {
+            version: string;
+            observedAt: string;
+        } | null;
+        availableProblem: {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors: Record<string, string[]>;
+            requiredActions: string[];
+            evidenceRefs: string[];
+            context: Record<string, unknown>;
+        } | null;
+        previous: {
+            version: string;
+            operationId: string;
+        } | null;
+        operation: {
+            id: string;
+            state: string;
+            phase: string;
+            targetVersion: string | null;
+            finishedAt: string | null;
+        } | null;
+        observedAt: string;
+    }, {
+        harness: string;
+        mechanism: "managed_npm" | "vendor_script" | "vendor_updater";
+        maintainable: boolean;
+        canCheckLatest: boolean;
+        targets: ("baseline" | "latest" | "previous" | "version")[];
+        remedy: string | null;
+        selection: {
+            kind: "managed" | "missing" | "override" | "path";
+            binary: string | null;
+            version: string | null;
+            overrideEnv: string | null;
+        };
+        installed: {
+            version: string | null;
+            binary: string | null;
+            proved: boolean;
+        };
+        releaseTested: {
+            version: string | null;
+            verification: "deterministic_only" | "release_verified" | null;
+        };
+        available: {
+            version: string;
+            observedAt: string;
+        } | null;
+        availableProblem: {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors?: Record<string, string[]> | undefined;
+            requiredActions?: string[] | undefined;
+            evidenceRefs?: string[] | undefined;
+            context?: Record<string, unknown> | undefined;
+        } | null;
+        previous: {
+            version: string;
+            operationId: string;
+        } | null;
+        operation: {
+            id: string;
+            state: string;
+            phase: string;
+            targetVersion: string | null;
+            finishedAt: string | null;
+        } | null;
+        observedAt: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    observedAt: string;
+    harnesses: {
+        harness: string;
+        mechanism: "managed_npm" | "vendor_script" | "vendor_updater";
+        maintainable: boolean;
+        canCheckLatest: boolean;
+        targets: ("baseline" | "latest" | "previous" | "version")[];
+        remedy: string | null;
+        selection: {
+            kind: "managed" | "missing" | "override" | "path";
+            binary: string | null;
+            version: string | null;
+            overrideEnv: string | null;
+        };
+        installed: {
+            version: string | null;
+            binary: string | null;
+            proved: boolean;
+        };
+        releaseTested: {
+            version: string | null;
+            verification: "deterministic_only" | "release_verified" | null;
+        };
+        available: {
+            version: string;
+            observedAt: string;
+        } | null;
+        availableProblem: {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors: Record<string, string[]>;
+            requiredActions: string[];
+            evidenceRefs: string[];
+            context: Record<string, unknown>;
+        } | null;
+        previous: {
+            version: string;
+            operationId: string;
+        } | null;
+        operation: {
+            id: string;
+            state: string;
+            phase: string;
+            targetVersion: string | null;
+            finishedAt: string | null;
+        } | null;
+        observedAt: string;
+    }[];
+}, {
+    observedAt: string;
+    harnesses: {
+        harness: string;
+        mechanism: "managed_npm" | "vendor_script" | "vendor_updater";
+        maintainable: boolean;
+        canCheckLatest: boolean;
+        targets: ("baseline" | "latest" | "previous" | "version")[];
+        remedy: string | null;
+        selection: {
+            kind: "managed" | "missing" | "override" | "path";
+            binary: string | null;
+            version: string | null;
+            overrideEnv: string | null;
+        };
+        installed: {
+            version: string | null;
+            binary: string | null;
+            proved: boolean;
+        };
+        releaseTested: {
+            version: string | null;
+            verification: "deterministic_only" | "release_verified" | null;
+        };
+        available: {
+            version: string;
+            observedAt: string;
+        } | null;
+        availableProblem: {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors?: Record<string, string[]> | undefined;
+            requiredActions?: string[] | undefined;
+            evidenceRefs?: string[] | undefined;
+            context?: Record<string, unknown> | undefined;
+        } | null;
+        previous: {
+            version: string;
+            operationId: string;
+        } | null;
+        operation: {
+            id: string;
+            state: string;
+            phase: string;
+            targetVersion: string | null;
+            finishedAt: string | null;
+        } | null;
+        observedAt: string;
+    }[];
+}>;
+export type ControlHarnessMaintenanceInventory = z.infer<typeof ControlHarnessMaintenanceInventory>;
+export declare const ControlHarnessMaintenanceCreateRequest: z.ZodObject<{
+    harness: z.ZodString;
+    target: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"latest">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "latest";
+    }, {
+        kind: "latest";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"version">;
+        version: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "version";
+        version: string;
+    }, {
+        kind: "version";
+        version: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"previous">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "previous";
+    }, {
+        kind: "previous";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"baseline">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "baseline";
+    }, {
+        kind: "baseline";
+    }>]>;
+}, "strict", z.ZodTypeAny, {
+    harness: string;
+    target: {
+        kind: "latest";
+    } | {
+        kind: "version";
+        version: string;
+    } | {
+        kind: "previous";
+    } | {
+        kind: "baseline";
+    };
+}, {
+    harness: string;
+    target: {
+        kind: "latest";
+    } | {
+        kind: "version";
+        version: string;
+    } | {
+        kind: "previous";
+    } | {
+        kind: "baseline";
+    };
+}>;
+export type ControlHarnessMaintenanceCreateRequest = z.infer<typeof ControlHarnessMaintenanceCreateRequest>;
+/** Durable command params; `target.version` is bound at acceptance for
+ * previous/baseline/version and stays null for latest until execution. */
+export declare const HarnessMaintenanceParams: z.ZodObject<{
+    kind: z.ZodLiteral<"harness_maintenance">;
+    harness: z.ZodString;
+    target: z.ZodObject<{
+        kind: z.ZodEnum<["latest", "version", "previous", "baseline"]>;
+        version: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "baseline" | "latest" | "previous" | "version";
+        version: string | null;
+    }, {
+        kind: "baseline" | "latest" | "previous" | "version";
+        version: string | null;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    kind: "harness_maintenance";
+    harness: string;
+    target: {
+        kind: "baseline" | "latest" | "previous" | "version";
+        version: string | null;
+    };
+}, {
+    kind: "harness_maintenance";
+    harness: string;
+    target: {
+        kind: "baseline" | "latest" | "previous" | "version";
+        version: string | null;
+    };
+}>;
+export type HarnessMaintenanceParams = z.infer<typeof HarnessMaintenanceParams>;
+export declare function isHarnessMaintenanceOperation(params: unknown): boolean;
+/** Evidence kept in the generic command record (JobRecord.result). */
+export declare const HarnessMaintenanceEvidence: z.ZodObject<{
+    phase: z.ZodEnum<["accepted", "preparing", "installing", "settled"]>;
+    mechanism: z.ZodNullable<z.ZodEnum<["managed_npm", "vendor_updater", "vendor_script"]>>;
+    target: z.ZodObject<{
+        kind: z.ZodEnum<["latest", "version", "previous", "baseline"]>;
+        version: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "baseline" | "latest" | "previous" | "version";
+        version: string | null;
+    }, {
+        kind: "baseline" | "latest" | "previous" | "version";
+        version: string | null;
+    }>;
+    before: z.ZodNullable<z.ZodObject<{
+        version: z.ZodNullable<z.ZodString>;
+        binary: z.ZodNullable<z.ZodString>;
+        selection: z.ZodEnum<["managed", "override", "path", "missing"]>;
+        proved: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        version: string | null;
+        binary: string | null;
+        selection: "managed" | "missing" | "override" | "path";
+        proved: boolean;
+    }, {
+        version: string | null;
+        binary: string | null;
+        selection: "managed" | "missing" | "override" | "path";
+        proved: boolean;
+    }>>;
+    after: z.ZodNullable<z.ZodObject<{
+        version: z.ZodNullable<z.ZodString>;
+        binary: z.ZodNullable<z.ZodString>;
+        selected: z.ZodBoolean;
+        proved: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        version: string | null;
+        binary: string | null;
+        selected: boolean;
+        proved: boolean;
+    }, {
+        version: string | null;
+        binary: string | null;
+        selected: boolean;
+        proved: boolean;
+    }>>;
+    mutation: z.ZodEnum<["none", "applied", "unknown"]>;
+    termination: z.ZodEnum<["not_applicable", "confirmed", "unconfirmed"]>;
+    limitations: z.ZodArray<z.ZodString, "many">;
+    progress: z.ZodArray<z.ZodString, "many">;
+    problem: z.ZodNullable<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        retryable: z.ZodBoolean;
+        fieldErrors: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+        requiredActions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strict", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors: Record<string, string[]>;
+        requiredActions: string[];
+        evidenceRefs: string[];
+        context: Record<string, unknown>;
+    }, {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors?: Record<string, string[]> | undefined;
+        requiredActions?: string[] | undefined;
+        evidenceRefs?: string[] | undefined;
+        context?: Record<string, unknown> | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    phase: "accepted" | "installing" | "preparing" | "settled";
+    mechanism: "managed_npm" | "vendor_script" | "vendor_updater" | null;
+    target: {
+        kind: "baseline" | "latest" | "previous" | "version";
+        version: string | null;
+    };
+    before: {
+        version: string | null;
+        binary: string | null;
+        selection: "managed" | "missing" | "override" | "path";
+        proved: boolean;
+    } | null;
+    after: {
+        version: string | null;
+        binary: string | null;
+        selected: boolean;
+        proved: boolean;
+    } | null;
+    mutation: "applied" | "none" | "unknown";
+    termination: "confirmed" | "not_applicable" | "unconfirmed";
+    limitations: string[];
+    progress: string[];
+    problem: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors: Record<string, string[]>;
+        requiredActions: string[];
+        evidenceRefs: string[];
+        context: Record<string, unknown>;
+    } | null;
+}, {
+    phase: "accepted" | "installing" | "preparing" | "settled";
+    mechanism: "managed_npm" | "vendor_script" | "vendor_updater" | null;
+    target: {
+        kind: "baseline" | "latest" | "previous" | "version";
+        version: string | null;
+    };
+    before: {
+        version: string | null;
+        binary: string | null;
+        selection: "managed" | "missing" | "override" | "path";
+        proved: boolean;
+    } | null;
+    after: {
+        version: string | null;
+        binary: string | null;
+        selected: boolean;
+        proved: boolean;
+    } | null;
+    mutation: "applied" | "none" | "unknown";
+    termination: "confirmed" | "not_applicable" | "unconfirmed";
+    limitations: string[];
+    progress: string[];
+    problem: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors?: Record<string, string[]> | undefined;
+        requiredActions?: string[] | undefined;
+        evidenceRefs?: string[] | undefined;
+        context?: Record<string, unknown> | undefined;
+    } | null;
+}>;
+export type HarnessMaintenanceEvidence = z.infer<typeof HarnessMaintenanceEvidence>;
+export declare const ControlHarnessMaintenanceOperation: z.ZodObject<{
+    phase: z.ZodEnum<["accepted", "preparing", "installing", "settled"]>;
+    mechanism: z.ZodNullable<z.ZodEnum<["managed_npm", "vendor_updater", "vendor_script"]>>;
+    target: z.ZodObject<{
+        kind: z.ZodEnum<["latest", "version", "previous", "baseline"]>;
+        version: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "baseline" | "latest" | "previous" | "version";
+        version: string | null;
+    }, {
+        kind: "baseline" | "latest" | "previous" | "version";
+        version: string | null;
+    }>;
+    before: z.ZodNullable<z.ZodObject<{
+        version: z.ZodNullable<z.ZodString>;
+        binary: z.ZodNullable<z.ZodString>;
+        selection: z.ZodEnum<["managed", "override", "path", "missing"]>;
+        proved: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        version: string | null;
+        binary: string | null;
+        selection: "managed" | "missing" | "override" | "path";
+        proved: boolean;
+    }, {
+        version: string | null;
+        binary: string | null;
+        selection: "managed" | "missing" | "override" | "path";
+        proved: boolean;
+    }>>;
+    after: z.ZodNullable<z.ZodObject<{
+        version: z.ZodNullable<z.ZodString>;
+        binary: z.ZodNullable<z.ZodString>;
+        selected: z.ZodBoolean;
+        proved: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        version: string | null;
+        binary: string | null;
+        selected: boolean;
+        proved: boolean;
+    }, {
+        version: string | null;
+        binary: string | null;
+        selected: boolean;
+        proved: boolean;
+    }>>;
+    mutation: z.ZodEnum<["none", "applied", "unknown"]>;
+    termination: z.ZodEnum<["not_applicable", "confirmed", "unconfirmed"]>;
+    limitations: z.ZodArray<z.ZodString, "many">;
+    progress: z.ZodArray<z.ZodString, "many">;
+    problem: z.ZodNullable<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        retryable: z.ZodBoolean;
+        fieldErrors: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+        requiredActions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strict", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors: Record<string, string[]>;
+        requiredActions: string[];
+        evidenceRefs: string[];
+        context: Record<string, unknown>;
+    }, {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors?: Record<string, string[]> | undefined;
+        requiredActions?: string[] | undefined;
+        evidenceRefs?: string[] | undefined;
+        context?: Record<string, unknown> | undefined;
+    }>>;
+} & {
+    id: z.ZodString;
+    harness: z.ZodString;
+    state: z.ZodEnum<["queued", "running", "succeeded", "failed", "cancelled", "interrupted"]>;
+    createdAt: z.ZodString;
+    startedAt: z.ZodNullable<z.ZodString>;
+    finishedAt: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    phase: "accepted" | "installing" | "preparing" | "settled";
+    mechanism: "managed_npm" | "vendor_script" | "vendor_updater" | null;
+    target: {
+        kind: "baseline" | "latest" | "previous" | "version";
+        version: string | null;
+    };
+    before: {
+        version: string | null;
+        binary: string | null;
+        selection: "managed" | "missing" | "override" | "path";
+        proved: boolean;
+    } | null;
+    after: {
+        version: string | null;
+        binary: string | null;
+        selected: boolean;
+        proved: boolean;
+    } | null;
+    mutation: "applied" | "none" | "unknown";
+    termination: "confirmed" | "not_applicable" | "unconfirmed";
+    limitations: string[];
+    progress: string[];
+    problem: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors: Record<string, string[]>;
+        requiredActions: string[];
+        evidenceRefs: string[];
+        context: Record<string, unknown>;
+    } | null;
+    id: string;
+    harness: string;
+    state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+    createdAt: string;
+    startedAt: string | null;
+    finishedAt: string | null;
+}, {
+    phase: "accepted" | "installing" | "preparing" | "settled";
+    mechanism: "managed_npm" | "vendor_script" | "vendor_updater" | null;
+    target: {
+        kind: "baseline" | "latest" | "previous" | "version";
+        version: string | null;
+    };
+    before: {
+        version: string | null;
+        binary: string | null;
+        selection: "managed" | "missing" | "override" | "path";
+        proved: boolean;
+    } | null;
+    after: {
+        version: string | null;
+        binary: string | null;
+        selected: boolean;
+        proved: boolean;
+    } | null;
+    mutation: "applied" | "none" | "unknown";
+    termination: "confirmed" | "not_applicable" | "unconfirmed";
+    limitations: string[];
+    progress: string[];
+    problem: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors?: Record<string, string[]> | undefined;
+        requiredActions?: string[] | undefined;
+        evidenceRefs?: string[] | undefined;
+        context?: Record<string, unknown> | undefined;
+    } | null;
+    id: string;
+    harness: string;
+    state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+    createdAt: string;
+    startedAt: string | null;
+    finishedAt: string | null;
+}>;
+export type ControlHarnessMaintenanceOperation = z.infer<typeof ControlHarnessMaintenanceOperation>;
+//# sourceMappingURL=harness-maintenance.d.ts.map