@agent-phonon/protocol 0.9.1 → 0.10.0

package/dist/schemas/maintenance.d.ts

@@ -0,0 +1,822 @@
+import { z } from "zod";
+/**
+ * Deterministic host-maintenance plane.
+ *
+ * Requests address locally configured target/config/service ids; the server can
+ * never supply raw host paths, package names, service names, or shell strings.
+ * Device policy remains authoritative for every action.
+ */
+export declare const MaintenancePermission: z.ZodObject<{
+    read: z.ZodBoolean;
+    configWrite: z.ZodBoolean;
+    packageUpdate: z.ZodBoolean;
+    serviceRestart: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    read: boolean;
+    configWrite: boolean;
+    packageUpdate: boolean;
+    serviceRestart: boolean;
+}, {
+    read: boolean;
+    configWrite: boolean;
+    packageUpdate: boolean;
+    serviceRestart: boolean;
+}>;
+export type MaintenancePermission = z.infer<typeof MaintenancePermission>;
+export declare const MaintenanceConfigFormat: z.ZodEnum<["json", "jsonc", "yaml", "toml", "text"]>;
+export type MaintenanceConfigFormat = z.infer<typeof MaintenanceConfigFormat>;
+export declare const MaintenanceConfigDescriptor: z.ZodObject<{
+    configId: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    format: z.ZodEnum<["json", "jsonc", "yaml", "toml", "text"]>;
+    textVisibility: z.ZodOptional<z.ZodEnum<["hidden", "public"]>>;
+    wholeFileWritable: z.ZodOptional<z.ZodBoolean>;
+    allowedRootKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    exists: z.ZodBoolean;
+    writable: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    format: "text" | "json" | "jsonc" | "yaml" | "toml";
+    exists: boolean;
+    configId: string;
+    writable: boolean;
+    label?: string | undefined;
+    textVisibility?: "public" | "hidden" | undefined;
+    wholeFileWritable?: boolean | undefined;
+    allowedRootKeys?: string[] | undefined;
+}, {
+    format: "text" | "json" | "jsonc" | "yaml" | "toml";
+    exists: boolean;
+    configId: string;
+    writable: boolean;
+    label?: string | undefined;
+    textVisibility?: "public" | "hidden" | undefined;
+    wholeFileWritable?: boolean | undefined;
+    allowedRootKeys?: string[] | undefined;
+}>;
+export type MaintenanceConfigDescriptor = z.infer<typeof MaintenanceConfigDescriptor>;
+export declare const MaintenanceServiceDescriptor: z.ZodObject<{
+    serviceId: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    configured: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    configured: boolean;
+    serviceId: string;
+    label?: string | undefined;
+}, {
+    configured: boolean;
+    serviceId: string;
+    label?: string | undefined;
+}>;
+export type MaintenanceServiceDescriptor = z.infer<typeof MaintenanceServiceDescriptor>;
+export declare const MaintenanceTargetDescriptor: z.ZodObject<{
+    targetId: z.ZodString;
+    label: z.ZodString;
+    command: z.ZodOptional<z.ZodString>;
+    packageUpdateConfigured: z.ZodBoolean;
+    configs: z.ZodArray<z.ZodObject<{
+        configId: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        format: z.ZodEnum<["json", "jsonc", "yaml", "toml", "text"]>;
+        textVisibility: z.ZodOptional<z.ZodEnum<["hidden", "public"]>>;
+        wholeFileWritable: z.ZodOptional<z.ZodBoolean>;
+        allowedRootKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        exists: z.ZodBoolean;
+        writable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        format: "text" | "json" | "jsonc" | "yaml" | "toml";
+        exists: boolean;
+        configId: string;
+        writable: boolean;
+        label?: string | undefined;
+        textVisibility?: "public" | "hidden" | undefined;
+        wholeFileWritable?: boolean | undefined;
+        allowedRootKeys?: string[] | undefined;
+    }, {
+        format: "text" | "json" | "jsonc" | "yaml" | "toml";
+        exists: boolean;
+        configId: string;
+        writable: boolean;
+        label?: string | undefined;
+        textVisibility?: "public" | "hidden" | undefined;
+        wholeFileWritable?: boolean | undefined;
+        allowedRootKeys?: string[] | undefined;
+    }>, "many">;
+    services: z.ZodArray<z.ZodObject<{
+        serviceId: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        configured: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        configured: boolean;
+        serviceId: string;
+        label?: string | undefined;
+    }, {
+        configured: boolean;
+        serviceId: string;
+        label?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    targetId: string;
+    packageUpdateConfigured: boolean;
+    configs: {
+        format: "text" | "json" | "jsonc" | "yaml" | "toml";
+        exists: boolean;
+        configId: string;
+        writable: boolean;
+        label?: string | undefined;
+        textVisibility?: "public" | "hidden" | undefined;
+        wholeFileWritable?: boolean | undefined;
+        allowedRootKeys?: string[] | undefined;
+    }[];
+    services: {
+        configured: boolean;
+        serviceId: string;
+        label?: string | undefined;
+    }[];
+    command?: string | undefined;
+}, {
+    label: string;
+    targetId: string;
+    packageUpdateConfigured: boolean;
+    configs: {
+        format: "text" | "json" | "jsonc" | "yaml" | "toml";
+        exists: boolean;
+        configId: string;
+        writable: boolean;
+        label?: string | undefined;
+        textVisibility?: "public" | "hidden" | undefined;
+        wholeFileWritable?: boolean | undefined;
+        allowedRootKeys?: string[] | undefined;
+    }[];
+    services: {
+        configured: boolean;
+        serviceId: string;
+        label?: string | undefined;
+    }[];
+    command?: string | undefined;
+}>;
+export type MaintenanceTargetDescriptor = z.infer<typeof MaintenanceTargetDescriptor>;
+export declare const MaintenanceTargetsParams: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+export declare const MaintenanceTargetsResult: z.ZodObject<{
+    permissions: z.ZodObject<{
+        read: z.ZodBoolean;
+        configWrite: z.ZodBoolean;
+        packageUpdate: z.ZodBoolean;
+        serviceRestart: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        read: boolean;
+        configWrite: boolean;
+        packageUpdate: boolean;
+        serviceRestart: boolean;
+    }, {
+        read: boolean;
+        configWrite: boolean;
+        packageUpdate: boolean;
+        serviceRestart: boolean;
+    }>;
+    targets: z.ZodArray<z.ZodObject<{
+        targetId: z.ZodString;
+        label: z.ZodString;
+        command: z.ZodOptional<z.ZodString>;
+        packageUpdateConfigured: z.ZodBoolean;
+        configs: z.ZodArray<z.ZodObject<{
+            configId: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            format: z.ZodEnum<["json", "jsonc", "yaml", "toml", "text"]>;
+            textVisibility: z.ZodOptional<z.ZodEnum<["hidden", "public"]>>;
+            wholeFileWritable: z.ZodOptional<z.ZodBoolean>;
+            allowedRootKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            exists: z.ZodBoolean;
+            writable: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            format: "text" | "json" | "jsonc" | "yaml" | "toml";
+            exists: boolean;
+            configId: string;
+            writable: boolean;
+            label?: string | undefined;
+            textVisibility?: "public" | "hidden" | undefined;
+            wholeFileWritable?: boolean | undefined;
+            allowedRootKeys?: string[] | undefined;
+        }, {
+            format: "text" | "json" | "jsonc" | "yaml" | "toml";
+            exists: boolean;
+            configId: string;
+            writable: boolean;
+            label?: string | undefined;
+            textVisibility?: "public" | "hidden" | undefined;
+            wholeFileWritable?: boolean | undefined;
+            allowedRootKeys?: string[] | undefined;
+        }>, "many">;
+        services: z.ZodArray<z.ZodObject<{
+            serviceId: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            configured: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            configured: boolean;
+            serviceId: string;
+            label?: string | undefined;
+        }, {
+            configured: boolean;
+            serviceId: string;
+            label?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        targetId: string;
+        packageUpdateConfigured: boolean;
+        configs: {
+            format: "text" | "json" | "jsonc" | "yaml" | "toml";
+            exists: boolean;
+            configId: string;
+            writable: boolean;
+            label?: string | undefined;
+            textVisibility?: "public" | "hidden" | undefined;
+            wholeFileWritable?: boolean | undefined;
+            allowedRootKeys?: string[] | undefined;
+        }[];
+        services: {
+            configured: boolean;
+            serviceId: string;
+            label?: string | undefined;
+        }[];
+        command?: string | undefined;
+    }, {
+        label: string;
+        targetId: string;
+        packageUpdateConfigured: boolean;
+        configs: {
+            format: "text" | "json" | "jsonc" | "yaml" | "toml";
+            exists: boolean;
+            configId: string;
+            writable: boolean;
+            label?: string | undefined;
+            textVisibility?: "public" | "hidden" | undefined;
+            wholeFileWritable?: boolean | undefined;
+            allowedRootKeys?: string[] | undefined;
+        }[];
+        services: {
+            configured: boolean;
+            serviceId: string;
+            label?: string | undefined;
+        }[];
+        command?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    targets: {
+        label: string;
+        targetId: string;
+        packageUpdateConfigured: boolean;
+        configs: {
+            format: "text" | "json" | "jsonc" | "yaml" | "toml";
+            exists: boolean;
+            configId: string;
+            writable: boolean;
+            label?: string | undefined;
+            textVisibility?: "public" | "hidden" | undefined;
+            wholeFileWritable?: boolean | undefined;
+            allowedRootKeys?: string[] | undefined;
+        }[];
+        services: {
+            configured: boolean;
+            serviceId: string;
+            label?: string | undefined;
+        }[];
+        command?: string | undefined;
+    }[];
+    permissions: {
+        read: boolean;
+        configWrite: boolean;
+        packageUpdate: boolean;
+        serviceRestart: boolean;
+    };
+}, {
+    targets: {
+        label: string;
+        targetId: string;
+        packageUpdateConfigured: boolean;
+        configs: {
+            format: "text" | "json" | "jsonc" | "yaml" | "toml";
+            exists: boolean;
+            configId: string;
+            writable: boolean;
+            label?: string | undefined;
+            textVisibility?: "public" | "hidden" | undefined;
+            wholeFileWritable?: boolean | undefined;
+            allowedRootKeys?: string[] | undefined;
+        }[];
+        services: {
+            configured: boolean;
+            serviceId: string;
+            label?: string | undefined;
+        }[];
+        command?: string | undefined;
+    }[];
+    permissions: {
+        read: boolean;
+        configWrite: boolean;
+        packageUpdate: boolean;
+        serviceRestart: boolean;
+    };
+}>;
+export declare const MaintenanceDiagnoseParams: z.ZodObject<{
+    targetId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    targetId?: string | undefined;
+}, {
+    targetId?: string | undefined;
+}>;
+export declare const MaintenanceDiagnostic: z.ZodObject<{
+    targetId: z.ZodString;
+    available: z.ZodBoolean;
+    version: z.ZodOptional<z.ZodString>;
+    versionError: z.ZodOptional<z.ZodString>;
+    configs: z.ZodArray<z.ZodObject<{
+        configId: z.ZodString;
+        exists: z.ZodBoolean;
+        valid: z.ZodOptional<z.ZodBoolean>;
+        sha256: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        exists: boolean;
+        configId: string;
+        valid?: boolean | undefined;
+        sha256?: string | undefined;
+        error?: string | undefined;
+    }, {
+        exists: boolean;
+        configId: string;
+        valid?: boolean | undefined;
+        sha256?: string | undefined;
+        error?: string | undefined;
+    }>, "many">;
+    services: z.ZodArray<z.ZodObject<{
+        serviceId: z.ZodString;
+        status: z.ZodEnum<["running", "stopped", "unknown", "not_configured"]>;
+        detail: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "unknown" | "running" | "stopped" | "not_configured";
+        serviceId: string;
+        detail?: string | undefined;
+    }, {
+        status: "unknown" | "running" | "stopped" | "not_configured";
+        serviceId: string;
+        detail?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    available: boolean;
+    targetId: string;
+    configs: {
+        exists: boolean;
+        configId: string;
+        valid?: boolean | undefined;
+        sha256?: string | undefined;
+        error?: string | undefined;
+    }[];
+    services: {
+        status: "unknown" | "running" | "stopped" | "not_configured";
+        serviceId: string;
+        detail?: string | undefined;
+    }[];
+    version?: string | undefined;
+    versionError?: string | undefined;
+}, {
+    available: boolean;
+    targetId: string;
+    configs: {
+        exists: boolean;
+        configId: string;
+        valid?: boolean | undefined;
+        sha256?: string | undefined;
+        error?: string | undefined;
+    }[];
+    services: {
+        status: "unknown" | "running" | "stopped" | "not_configured";
+        serviceId: string;
+        detail?: string | undefined;
+    }[];
+    version?: string | undefined;
+    versionError?: string | undefined;
+}>;
+export declare const MaintenanceDiagnoseResult: z.ZodObject<{
+    diagnostics: z.ZodArray<z.ZodObject<{
+        targetId: z.ZodString;
+        available: z.ZodBoolean;
+        version: z.ZodOptional<z.ZodString>;
+        versionError: z.ZodOptional<z.ZodString>;
+        configs: z.ZodArray<z.ZodObject<{
+            configId: z.ZodString;
+            exists: z.ZodBoolean;
+            valid: z.ZodOptional<z.ZodBoolean>;
+            sha256: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            exists: boolean;
+            configId: string;
+            valid?: boolean | undefined;
+            sha256?: string | undefined;
+            error?: string | undefined;
+        }, {
+            exists: boolean;
+            configId: string;
+            valid?: boolean | undefined;
+            sha256?: string | undefined;
+            error?: string | undefined;
+        }>, "many">;
+        services: z.ZodArray<z.ZodObject<{
+            serviceId: z.ZodString;
+            status: z.ZodEnum<["running", "stopped", "unknown", "not_configured"]>;
+            detail: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            status: "unknown" | "running" | "stopped" | "not_configured";
+            serviceId: string;
+            detail?: string | undefined;
+        }, {
+            status: "unknown" | "running" | "stopped" | "not_configured";
+            serviceId: string;
+            detail?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        available: boolean;
+        targetId: string;
+        configs: {
+            exists: boolean;
+            configId: string;
+            valid?: boolean | undefined;
+            sha256?: string | undefined;
+            error?: string | undefined;
+        }[];
+        services: {
+            status: "unknown" | "running" | "stopped" | "not_configured";
+            serviceId: string;
+            detail?: string | undefined;
+        }[];
+        version?: string | undefined;
+        versionError?: string | undefined;
+    }, {
+        available: boolean;
+        targetId: string;
+        configs: {
+            exists: boolean;
+            configId: string;
+            valid?: boolean | undefined;
+            sha256?: string | undefined;
+            error?: string | undefined;
+        }[];
+        services: {
+            status: "unknown" | "running" | "stopped" | "not_configured";
+            serviceId: string;
+            detail?: string | undefined;
+        }[];
+        version?: string | undefined;
+        versionError?: string | undefined;
+    }>, "many">;
+    at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    diagnostics: {
+        available: boolean;
+        targetId: string;
+        configs: {
+            exists: boolean;
+            configId: string;
+            valid?: boolean | undefined;
+            sha256?: string | undefined;
+            error?: string | undefined;
+        }[];
+        services: {
+            status: "unknown" | "running" | "stopped" | "not_configured";
+            serviceId: string;
+            detail?: string | undefined;
+        }[];
+        version?: string | undefined;
+        versionError?: string | undefined;
+    }[];
+}, {
+    at: string;
+    diagnostics: {
+        available: boolean;
+        targetId: string;
+        configs: {
+            exists: boolean;
+            configId: string;
+            valid?: boolean | undefined;
+            sha256?: string | undefined;
+            error?: string | undefined;
+        }[];
+        services: {
+            status: "unknown" | "running" | "stopped" | "not_configured";
+            serviceId: string;
+            detail?: string | undefined;
+        }[];
+        version?: string | undefined;
+        versionError?: string | undefined;
+    }[];
+}>;
+export declare const MaintenanceConfigGetParams: z.ZodObject<{
+    targetId: z.ZodString;
+    configId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    configId: string;
+    targetId: string;
+}, {
+    configId: string;
+    targetId: string;
+}>;
+export declare const MaintenanceConfigGetResult: z.ZodObject<{
+    targetId: z.ZodString;
+    configId: z.ZodString;
+    exists: z.ZodBoolean;
+    sha256: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<["json", "jsonc", "yaml", "toml", "text"]>>;
+    text: z.ZodOptional<z.ZodString>;
+    textWithheld: z.ZodOptional<z.ZodBoolean>;
+    /** Parsed value with secret-looking fields recursively redacted; TOML special types use tagged diagnostic projections. */
+    value: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    exists: boolean;
+    configId: string;
+    targetId: string;
+    value?: unknown;
+    format?: "text" | "json" | "jsonc" | "yaml" | "toml" | undefined;
+    sha256?: string | undefined;
+    text?: string | undefined;
+    textWithheld?: boolean | undefined;
+}, {
+    exists: boolean;
+    configId: string;
+    targetId: string;
+    value?: unknown;
+    format?: "text" | "json" | "jsonc" | "yaml" | "toml" | undefined;
+    sha256?: string | undefined;
+    text?: string | undefined;
+    textWithheld?: boolean | undefined;
+}>;
+export declare const MaintenanceConfigPatchParams: z.ZodObject<{
+    targetId: z.ZodString;
+    configId: z.ZodString;
+    /** Optimistic lock from maintenance.config.get. Required to prevent stale overwrite. */
+    expectedSha256: z.ZodString;
+    /** RFC 7396-style JSON merge patch. Arrays are replaced as a whole. */
+    patch: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    reason: z.ZodOptional<z.ZodString>;
+    clientRequestId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    patch: Record<string, unknown>;
+    configId: string;
+    targetId: string;
+    expectedSha256: string;
+    clientRequestId?: string | undefined;
+    reason?: string | undefined;
+}, {
+    patch: Record<string, unknown>;
+    configId: string;
+    targetId: string;
+    expectedSha256: string;
+    clientRequestId?: string | undefined;
+    reason?: string | undefined;
+}>;
+export declare const MaintenanceConfigPatchResult: z.ZodObject<{
+    targetId: z.ZodString;
+    configId: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<["json", "jsonc", "yaml", "toml", "text"]>>;
+    changed: z.ZodBoolean;
+    previousSha256: z.ZodString;
+    sha256: z.ZodString;
+    backupId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sha256: string;
+    configId: string;
+    targetId: string;
+    changed: boolean;
+    previousSha256: string;
+    format?: "text" | "json" | "jsonc" | "yaml" | "toml" | undefined;
+    backupId?: string | undefined;
+}, {
+    sha256: string;
+    configId: string;
+    targetId: string;
+    changed: boolean;
+    previousSha256: string;
+    format?: "text" | "json" | "jsonc" | "yaml" | "toml" | undefined;
+    backupId?: string | undefined;
+}>;
+export declare const MaintenanceConfigEditParams: z.ZodObject<{
+    targetId: z.ZodString;
+    configId: z.ZodString;
+    expectedSha256: z.ZodString;
+    edits: z.ZodArray<z.ZodObject<{
+        oldText: z.ZodString;
+        newText: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        oldText: string;
+        newText: string;
+    }, {
+        oldText: string;
+        newText: string;
+    }>, "many">;
+    reason: z.ZodOptional<z.ZodString>;
+    clientRequestId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    configId: string;
+    targetId: string;
+    expectedSha256: string;
+    edits: {
+        oldText: string;
+        newText: string;
+    }[];
+    clientRequestId?: string | undefined;
+    reason?: string | undefined;
+}, {
+    configId: string;
+    targetId: string;
+    expectedSha256: string;
+    edits: {
+        oldText: string;
+        newText: string;
+    }[];
+    clientRequestId?: string | undefined;
+    reason?: string | undefined;
+}>;
+export declare const MaintenanceConfigEditResult: z.ZodObject<{
+    targetId: z.ZodString;
+    configId: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<["json", "jsonc", "yaml", "toml", "text"]>>;
+    changed: z.ZodBoolean;
+    previousSha256: z.ZodString;
+    sha256: z.ZodString;
+    backupId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sha256: string;
+    configId: string;
+    targetId: string;
+    changed: boolean;
+    previousSha256: string;
+    format?: "text" | "json" | "jsonc" | "yaml" | "toml" | undefined;
+    backupId?: string | undefined;
+}, {
+    sha256: string;
+    configId: string;
+    targetId: string;
+    changed: boolean;
+    previousSha256: string;
+    format?: "text" | "json" | "jsonc" | "yaml" | "toml" | undefined;
+    backupId?: string | undefined;
+}>;
+export type MaintenanceConfigEditParams = z.infer<typeof MaintenanceConfigEditParams>;
+export type MaintenanceConfigEditResult = z.infer<typeof MaintenanceConfigEditResult>;
+export declare const MaintenanceRollbackParams: z.ZodObject<{
+    backupId: z.ZodString;
+    /** Current config hash, preventing a stale rollback from clobbering later edits. */
+    expectedCurrentSha256: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    clientRequestId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    backupId: string;
+    expectedCurrentSha256: string;
+    clientRequestId?: string | undefined;
+    reason?: string | undefined;
+}, {
+    backupId: string;
+    expectedCurrentSha256: string;
+    clientRequestId?: string | undefined;
+    reason?: string | undefined;
+}>;
+export declare const MaintenanceRollbackResult: z.ZodObject<{
+    backupId: z.ZodString;
+    targetId: z.ZodString;
+    configId: z.ZodString;
+    restored: z.ZodLiteral<true>;
+    sha256: z.ZodString;
+    /** Backup of the state replaced by rollback, allowing an immediate roll-forward. */
+    reversibleBackupId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sha256: string;
+    configId: string;
+    targetId: string;
+    backupId: string;
+    restored: true;
+    reversibleBackupId?: string | undefined;
+}, {
+    sha256: string;
+    configId: string;
+    targetId: string;
+    backupId: string;
+    restored: true;
+    reversibleBackupId?: string | undefined;
+}>;
+export declare const MaintenancePackageUpdateParams: z.ZodObject<{
+    targetId: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    clientRequestId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    targetId: string;
+    version?: string | undefined;
+    clientRequestId?: string | undefined;
+}, {
+    targetId: string;
+    version?: string | undefined;
+    clientRequestId?: string | undefined;
+}>;
+export declare const MaintenancePackageUpdateResult: z.ZodObject<{
+    targetId: z.ZodString;
+    manager: z.ZodEnum<["npm", "pnpm"]>;
+    packageName: z.ZodString;
+    requestedVersion: z.ZodString;
+    exitCode: z.ZodNumber;
+    stdout: z.ZodString;
+    stderr: z.ZodString;
+    versionAfter: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    targetId: string;
+    manager: "npm" | "pnpm";
+    packageName: string;
+    requestedVersion: string;
+    versionAfter?: string | undefined;
+}, {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    targetId: string;
+    manager: "npm" | "pnpm";
+    packageName: string;
+    requestedVersion: string;
+    versionAfter?: string | undefined;
+}>;
+export declare const MaintenanceServiceStatusParams: z.ZodObject<{
+    targetId: z.ZodString;
+    serviceId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    serviceId: string;
+    targetId: string;
+}, {
+    serviceId: string;
+    targetId: string;
+}>;
+export declare const MaintenanceServiceStatusResult: z.ZodObject<{
+    targetId: z.ZodString;
+    serviceId: z.ZodString;
+    status: z.ZodEnum<["running", "stopped", "unknown", "not_configured"]>;
+    detail: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "unknown" | "running" | "stopped" | "not_configured";
+    serviceId: string;
+    targetId: string;
+    detail?: string | undefined;
+}, {
+    status: "unknown" | "running" | "stopped" | "not_configured";
+    serviceId: string;
+    targetId: string;
+    detail?: string | undefined;
+}>;
+export declare const MaintenanceServiceRestartParams: z.ZodObject<{
+    targetId: z.ZodString;
+    serviceId: z.ZodString;
+    clientRequestId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    serviceId: string;
+    targetId: string;
+    clientRequestId?: string | undefined;
+}, {
+    serviceId: string;
+    targetId: string;
+    clientRequestId?: string | undefined;
+}>;
+export declare const MaintenanceServiceRestartResult: z.ZodObject<{
+    targetId: z.ZodString;
+    serviceId: z.ZodString;
+    restarted: z.ZodBoolean;
+    status: z.ZodEnum<["running", "stopped", "unknown", "not_configured"]>;
+    detail: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "unknown" | "running" | "stopped" | "not_configured";
+    serviceId: string;
+    targetId: string;
+    restarted: boolean;
+    detail?: string | undefined;
+}, {
+    status: "unknown" | "running" | "stopped" | "not_configured";
+    serviceId: string;
+    targetId: string;
+    restarted: boolean;
+    detail?: string | undefined;
+}>;
+export type MaintenanceTargetsParams = z.infer<typeof MaintenanceTargetsParams>;
+export type MaintenanceTargetsResult = z.infer<typeof MaintenanceTargetsResult>;
+export type MaintenanceDiagnoseParams = z.infer<typeof MaintenanceDiagnoseParams>;
+export type MaintenanceDiagnoseResult = z.infer<typeof MaintenanceDiagnoseResult>;
+export type MaintenanceConfigGetParams = z.infer<typeof MaintenanceConfigGetParams>;
+export type MaintenanceConfigGetResult = z.infer<typeof MaintenanceConfigGetResult>;
+export type MaintenanceConfigPatchParams = z.infer<typeof MaintenanceConfigPatchParams>;
+export type MaintenanceConfigPatchResult = z.infer<typeof MaintenanceConfigPatchResult>;
+export type MaintenanceRollbackParams = z.infer<typeof MaintenanceRollbackParams>;
+export type MaintenanceRollbackResult = z.infer<typeof MaintenanceRollbackResult>;
+export type MaintenancePackageUpdateParams = z.infer<typeof MaintenancePackageUpdateParams>;
+export type MaintenancePackageUpdateResult = z.infer<typeof MaintenancePackageUpdateResult>;
+export type MaintenanceServiceStatusParams = z.infer<typeof MaintenanceServiceStatusParams>;
+export type MaintenanceServiceStatusResult = z.infer<typeof MaintenanceServiceStatusResult>;
+export type MaintenanceServiceRestartParams = z.infer<typeof MaintenanceServiceRestartParams>;
+export type MaintenanceServiceRestartResult = z.infer<typeof MaintenanceServiceRestartResult>;
+//# sourceMappingURL=maintenance.d.ts.map