@maudecode/talaria-web-contracts 1.20.0 → 1.21.0

package/dist/routes/tools.d.ts

@@ -23,6 +23,58 @@ export declare const MemoryWriteRefusalSchema: z.ZodUnion<readonly [z.ZodObject<
     code: z.ZodLiteral<"memory_conflict">;
 }, z.core.$strip>]>;
 export type MemoryWriteRefusal = z.infer<typeof MemoryWriteRefusalSchema>;
+/** User-requested preview, separate from Agent pending writes; apply accepts only this opaque receipt. */
+export declare const MemoryCompactionPreviewSchema: z.ZodObject<{
+    section: z.ZodEnum<{
+        memory: "memory";
+        user: "user";
+    }>;
+    revision: z.ZodString;
+    proposed_revision: z.ZodString;
+    receipt: z.ZodString;
+    source: z.ZodString;
+    proposed: z.ZodString;
+    diff: z.ZodString;
+    model: z.ZodString;
+    expires_at: z.ZodNumber;
+}, z.core.$strip>;
+export type MemoryCompactionPreview = z.infer<typeof MemoryCompactionPreviewSchema>;
+export declare const MemoryCompactionApplySchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    section: z.ZodEnum<{
+        memory: "memory";
+        user: "user";
+    }>;
+    revision: z.ZodString;
+}, z.core.$strip>;
+export declare const MemoryCompactionRefusalSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
+    error: z.ZodString;
+    code: z.ZodLiteral<"memory_char_limit">;
+    char_limit: z.ZodObject<{
+        count: z.ZodNumber;
+        limit: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    error: z.ZodString;
+    code: z.ZodEnum<{
+        memory_mask_ambiguous: "memory_mask_ambiguous";
+        memory_mask_edited: "memory_mask_edited";
+    }>;
+    mask: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    error: z.ZodString;
+    code: z.ZodLiteral<"memory_conflict">;
+}, z.core.$strip>]>, z.ZodObject<{
+    error: z.ZodString;
+    code: z.ZodEnum<{
+        memory_compaction_conflict: "memory_compaction_conflict";
+        memory_compaction_invalid: "memory_compaction_invalid";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    error: z.ZodString;
+    code: z.ZodLiteral<"memory_compaction_unavailable">;
+    condition: z.ZodString;
+}, z.core.$strip>]>;
 /** TAL-819: a kind's staged writes and whether the page shows its review panel. */
 export declare const PendingWritesSchema: z.ZodObject<{
     kind: z.ZodEnum<{
@@ -136,6 +188,36 @@ export declare const toolsContract: {
         }, z.core.$strip>, Record<never, never>, Record<never, never>>;
     };
     memory: {
+        compactionPreview: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            section: z.ZodEnum<{
+                memory: "memory";
+                user: "user";
+            }>;
+            revision: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            section: z.ZodEnum<{
+                memory: "memory";
+                user: "user";
+            }>;
+            revision: z.ZodString;
+            proposed_revision: z.ZodString;
+            receipt: z.ZodString;
+            source: z.ZodString;
+            proposed: z.ZodString;
+            diff: z.ZodString;
+            model: z.ZodString;
+            expires_at: z.ZodNumber;
+        }, z.core.$strip>, Record<never, never>, Record<never, never>>;
+        compactionApply: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            receipt: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            ok: z.ZodLiteral<true>;
+            section: z.ZodEnum<{
+                memory: "memory";
+                user: "user";
+            }>;
+            revision: z.ZodString;
+        }, z.core.$strip>, Record<never, never>, Record<never, never>>;
         get: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
             session_id: z.ZodOptional<z.ZodString>;
             workspace: z.ZodOptional<z.ZodString>;
@@ -550,6 +632,7 @@ export declare const toolsContract: {
             }, z.core.$loose>>;
             docs: z.ZodObject<{
                 project: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    name: z.ZodOptional<z.ZodString>;
                     path: z.ZodOptional<z.ZodString>;
                     content: z.ZodOptional<z.ZodString>;
                     lines: z.ZodOptional<z.ZodNumber>;
@@ -571,8 +654,15 @@ export declare const toolsContract: {
                     table: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString>>>;
                     table_truncated: z.ZodOptional<z.ZodBoolean>;
                     preview_url: z.ZodOptional<z.ZodString>;
+                    source: z.ZodOptional<z.ZodEnum<{
+                        workspace: "workspace";
+                        managed: "managed";
+                    }>>;
+                    read_only: z.ZodOptional<z.ZodBoolean>;
+                    write_semantics: z.ZodOptional<z.ZodLiteral<"unconditional">>;
                 }, z.core.$loose>>>;
                 plan: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    name: z.ZodOptional<z.ZodString>;
                     path: z.ZodOptional<z.ZodString>;
                     content: z.ZodOptional<z.ZodString>;
                     lines: z.ZodOptional<z.ZodNumber>;
@@ -594,8 +684,15 @@ export declare const toolsContract: {
                     table: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString>>>;
                     table_truncated: z.ZodOptional<z.ZodBoolean>;
                     preview_url: z.ZodOptional<z.ZodString>;
+                    source: z.ZodOptional<z.ZodEnum<{
+                        workspace: "workspace";
+                        managed: "managed";
+                    }>>;
+                    read_only: z.ZodOptional<z.ZodBoolean>;
+                    write_semantics: z.ZodOptional<z.ZodLiteral<"unconditional">>;
                 }, z.core.$loose>>>;
                 status: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    name: z.ZodOptional<z.ZodString>;
                     path: z.ZodOptional<z.ZodString>;
                     content: z.ZodOptional<z.ZodString>;
                     lines: z.ZodOptional<z.ZodNumber>;
@@ -617,8 +714,15 @@ export declare const toolsContract: {
                     table: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString>>>;
                     table_truncated: z.ZodOptional<z.ZodBoolean>;
                     preview_url: z.ZodOptional<z.ZodString>;
+                    source: z.ZodOptional<z.ZodEnum<{
+                        workspace: "workspace";
+                        managed: "managed";
+                    }>>;
+                    read_only: z.ZodOptional<z.ZodBoolean>;
+                    write_semantics: z.ZodOptional<z.ZodLiteral<"unconditional">>;
                 }, z.core.$loose>>>;
                 blocker_resolver: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    name: z.ZodOptional<z.ZodString>;
                     path: z.ZodOptional<z.ZodString>;
                     content: z.ZodOptional<z.ZodString>;
                     lines: z.ZodOptional<z.ZodNumber>;
@@ -640,6 +744,12 @@ export declare const toolsContract: {
                     table: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString>>>;
                     table_truncated: z.ZodOptional<z.ZodBoolean>;
                     preview_url: z.ZodOptional<z.ZodString>;
+                    source: z.ZodOptional<z.ZodEnum<{
+                        workspace: "workspace";
+                        managed: "managed";
+                    }>>;
+                    read_only: z.ZodOptional<z.ZodBoolean>;
+                    write_semantics: z.ZodOptional<z.ZodLiteral<"unconditional">>;
                 }, z.core.$loose>>>;
             }, z.core.$strip>;
             handoff: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -778,6 +888,55 @@ export declare const toolsContract: {
     mcp: {
         servers: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, z.ZodObject<{
             servers: z.ZodArray<z.ZodObject<{
+                cost_policy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    error: z.ZodNullable<z.ZodString>;
+                    source: z.ZodEnum<{
+                        native: "native";
+                        package: "package";
+                        native_override: "native_override";
+                    }>;
+                    can_edit: z.ZodBoolean;
+                    tool_costs: z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        low: z.ZodNumber;
+                        high: z.ZodNumber;
+                        note: z.ZodString;
+                    }, z.core.$strip>>;
+                    spend_limit: z.ZodNumber;
+                    cost_unit: z.ZodString;
+                    name: z.ZodString;
+                    valid: z.ZodBoolean;
+                    overrides: z.ZodObject<{
+                        tool_costs: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>]>, z.ZodObject<{
+                            credits: z.ZodUnion<readonly [z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>]>;
+                            note: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strict>]>>>;
+                        spend_limit: z.ZodNullable<z.ZodNumber>;
+                        cost_unit: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>;
+                    budget_enabled: z.ZodBoolean;
+                    field_sources: z.ZodObject<{
+                        tool_costs: z.ZodEnum<{
+                            default: "default";
+                            native: "native";
+                            package: "package";
+                        }>;
+                        spend_limit: z.ZodEnum<{
+                            default: "default";
+                            native: "native";
+                            package: "package";
+                        }>;
+                        cost_unit: z.ZodEnum<{
+                            default: "default";
+                            native: "native";
+                            package: "package";
+                        }>;
+                    }, z.core.$strip>;
+                    revision: z.ZodString;
+                    provenance: z.ZodLiteral<"declared_estimate">;
+                    reload_required: z.ZodLiteral<true>;
+                    runtime_state: z.ZodLiteral<"unknown">;
+                }, z.core.$strip>>>;
                 name: z.ZodString;
                 id: z.ZodOptional<z.ZodString>;
                 transport: z.ZodOptional<z.ZodString>;
@@ -822,9 +981,67 @@ export declare const toolsContract: {
         }, z.core.$strip>, Record<never, never>, Record<never, never>>;
         update: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
             name: z.ZodString;
+            config_revision: z.ZodOptional<z.ZodString>;
+            cost_policy: z.ZodOptional<z.ZodObject<{
+                tool_costs: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>]>, z.ZodObject<{
+                    credits: z.ZodUnion<readonly [z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>]>;
+                    note: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>]>>>>;
+                spend_limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                cost_unit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>;
         }, z.core.$catchall<z.ZodUnknown>>, z.ZodObject<{
             ok: z.ZodLiteral<true>;
             server: z.ZodObject<{
+                cost_policy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    error: z.ZodNullable<z.ZodString>;
+                    source: z.ZodEnum<{
+                        native: "native";
+                        package: "package";
+                        native_override: "native_override";
+                    }>;
+                    can_edit: z.ZodBoolean;
+                    tool_costs: z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        low: z.ZodNumber;
+                        high: z.ZodNumber;
+                        note: z.ZodString;
+                    }, z.core.$strip>>;
+                    spend_limit: z.ZodNumber;
+                    cost_unit: z.ZodString;
+                    name: z.ZodString;
+                    valid: z.ZodBoolean;
+                    overrides: z.ZodObject<{
+                        tool_costs: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>]>, z.ZodObject<{
+                            credits: z.ZodUnion<readonly [z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>]>;
+                            note: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strict>]>>>;
+                        spend_limit: z.ZodNullable<z.ZodNumber>;
+                        cost_unit: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>;
+                    budget_enabled: z.ZodBoolean;
+                    field_sources: z.ZodObject<{
+                        tool_costs: z.ZodEnum<{
+                            default: "default";
+                            native: "native";
+                            package: "package";
+                        }>;
+                        spend_limit: z.ZodEnum<{
+                            default: "default";
+                            native: "native";
+                            package: "package";
+                        }>;
+                        cost_unit: z.ZodEnum<{
+                            default: "default";
+                            native: "native";
+                            package: "package";
+                        }>;
+                    }, z.core.$strip>;
+                    revision: z.ZodString;
+                    provenance: z.ZodLiteral<"declared_estimate">;
+                    reload_required: z.ZodLiteral<true>;
+                    runtime_state: z.ZodLiteral<"unknown">;
+                }, z.core.$strip>>>;
                 name: z.ZodString;
                 id: z.ZodOptional<z.ZodString>;
                 transport: z.ZodOptional<z.ZodString>;
@@ -873,8 +1090,8 @@ export declare const toolsContract: {
                     problem: z.ZodNullable<z.ZodEnum<{
                         pending: "pending";
                         expired: "expired";
-                        revoked: "revoked";
                         failed: "failed";
+                        revoked: "revoked";
                         inactive: "inactive";
                     }>>;
                     status_reason: z.ZodNullable<z.ZodString>;
@@ -939,17 +1156,17 @@ export declare const toolsContract: {
                     pending: "pending";
                     expired: "expired";
                     skipped: "skipped";
+                    failed: "failed";
                     initiated: "initiated";
                     connected: "connected";
-                    failed: "failed";
                     not_connected: "not_connected";
                 }>;
                 detail: z.ZodString;
                 connect_url: z.ZodNullable<z.ZodString>;
                 actions: z.ZodArray<z.ZodEnum<{
                     retry: "retry";
-                    skip: "skip";
                     approve: "approve";
+                    skip: "skip";
                 }>>;
                 env_fields: z.ZodArray<z.ZodObject<{
                     name: z.ZodString;
@@ -983,17 +1200,17 @@ export declare const toolsContract: {
                     pending: "pending";
                     expired: "expired";
                     skipped: "skipped";
+                    failed: "failed";
                     initiated: "initiated";
                     connected: "connected";
-                    failed: "failed";
                     not_connected: "not_connected";
                 }>;
                 detail: z.ZodString;
                 connect_url: z.ZodNullable<z.ZodString>;
                 actions: z.ZodArray<z.ZodEnum<{
                     retry: "retry";
-                    skip: "skip";
                     approve: "approve";
+                    skip: "skip";
                 }>>;
                 env_fields: z.ZodArray<z.ZodObject<{
                     name: z.ZodString;
@@ -1007,8 +1224,8 @@ export declare const toolsContract: {
             op_id: z.ZodString;
             action: z.ZodEnum<{
                 retry: "retry";
-                skip: "skip";
                 approve: "approve";
+                skip: "skip";
                 continue: "continue";
             }>;
             target: z.ZodOptional<z.ZodString>;
@@ -1030,17 +1247,17 @@ export declare const toolsContract: {
                     pending: "pending";
                     expired: "expired";
                     skipped: "skipped";
+                    failed: "failed";
                     initiated: "initiated";
                     connected: "connected";
-                    failed: "failed";
                     not_connected: "not_connected";
                 }>;
                 detail: z.ZodString;
                 connect_url: z.ZodNullable<z.ZodString>;
                 actions: z.ZodArray<z.ZodEnum<{
                     retry: "retry";
-                    skip: "skip";
                     approve: "approve";
+                    skip: "skip";
                 }>>;
                 env_fields: z.ZodArray<z.ZodObject<{
                     name: z.ZodString;
@@ -1239,6 +1456,28 @@ export declare const toolsContract: {
                 attempt: z.ZodNumber;
                 detail: z.ZodString;
                 retry_at: z.ZodNullable<z.ZodString>;
+                operation_id: z.ZodOptional<z.ZodUUID>;
+                operation: z.ZodOptional<z.ZodObject<{
+                    operation_id: z.ZodUUID;
+                    baseline_revision: z.ZodString;
+                    target_revision: z.ZodString;
+                    stage: z.ZodEnum<{
+                        install: "install";
+                        gateway_restart: "gateway_restart";
+                        agent_ready: "agent_ready";
+                    }>;
+                    recovered_revision: z.ZodOptional<z.ZodString>;
+                    source_moved: z.ZodOptional<z.ZodBoolean>;
+                    attempt_error: z.ZodOptional<z.ZodString>;
+                    failed_stage: z.ZodOptional<z.ZodEnum<{
+                        install: "install";
+                        gateway_restart: "gateway_restart";
+                        agent_ready: "agent_ready";
+                    }>>;
+                }, z.core.$strip>>;
+                verified_revision: z.ZodOptional<z.ZodString>;
+                runtime_revision: z.ZodOptional<z.ZodString>;
+                verified_version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             }, z.core.$strip>>;
             disabled: z.ZodOptional<z.ZodBoolean>;
             cached: z.ZodOptional<z.ZodBoolean>;
@@ -1413,6 +1652,28 @@ export declare const toolsContract: {
                 attempt: z.ZodNumber;
                 detail: z.ZodString;
                 retry_at: z.ZodNullable<z.ZodString>;
+                operation_id: z.ZodOptional<z.ZodUUID>;
+                operation: z.ZodOptional<z.ZodObject<{
+                    operation_id: z.ZodUUID;
+                    baseline_revision: z.ZodString;
+                    target_revision: z.ZodString;
+                    stage: z.ZodEnum<{
+                        install: "install";
+                        gateway_restart: "gateway_restart";
+                        agent_ready: "agent_ready";
+                    }>;
+                    recovered_revision: z.ZodOptional<z.ZodString>;
+                    source_moved: z.ZodOptional<z.ZodBoolean>;
+                    attempt_error: z.ZodOptional<z.ZodString>;
+                    failed_stage: z.ZodOptional<z.ZodEnum<{
+                        install: "install";
+                        gateway_restart: "gateway_restart";
+                        agent_ready: "agent_ready";
+                    }>>;
+                }, z.core.$strip>>;
+                verified_revision: z.ZodOptional<z.ZodString>;
+                runtime_revision: z.ZodOptional<z.ZodString>;
+                verified_version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             }, z.core.$strip>>;
             disabled: z.ZodOptional<z.ZodBoolean>;
             cached: z.ZodOptional<z.ZodBoolean>;
@@ -1580,6 +1841,10 @@ export declare const toolsContract: {
             target: z.ZodOptional<z.ZodString>;
             channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>, z.ZodObject<{
+            recovery_only: z.ZodOptional<z.ZodBoolean>;
+            recovery_pending: z.ZodOptional<z.ZodBoolean>;
+            verified_revision: z.ZodOptional<z.ZodString>;
+            verified_version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             recovery_compatibility: z.ZodOptional<z.ZodObject<{
                 manual_execution: z.ZodBoolean;
                 bot_chat_delivery: z.ZodBoolean;
@@ -1620,6 +1885,10 @@ export declare const toolsContract: {
             target: z.ZodOptional<z.ZodString>;
             channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>, z.ZodObject<{
+            recovery_only: z.ZodOptional<z.ZodBoolean>;
+            recovery_pending: z.ZodOptional<z.ZodBoolean>;
+            verified_revision: z.ZodOptional<z.ZodString>;
+            verified_version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             recovery_compatibility: z.ZodOptional<z.ZodObject<{
                 manual_execution: z.ZodBoolean;
                 bot_chat_delivery: z.ZodBoolean;
@@ -1660,6 +1929,10 @@ export declare const toolsContract: {
             target: z.ZodOptional<z.ZodString>;
             channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>, z.ZodObject<{
+            recovery_only: z.ZodOptional<z.ZodBoolean>;
+            recovery_pending: z.ZodOptional<z.ZodBoolean>;
+            verified_revision: z.ZodOptional<z.ZodString>;
+            verified_version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             recovery_compatibility: z.ZodOptional<z.ZodObject<{
                 manual_execution: z.ZodBoolean;
                 bot_chat_delivery: z.ZodBoolean;
@@ -1747,6 +2020,7 @@ export declare const toolsContract: {
                     awaiting_confirmation: "awaiting_confirmation";
                     waiting_for_idle: "waiting_for_idle";
                     verifying: "verifying";
+                    recovering: "recovering";
                     succeeded: "succeeded";
                 }>, z.ZodString]>;
                 severity: z.ZodEnum<{
@@ -1780,18 +2054,50 @@ export declare const toolsContract: {
                 verified_revision: z.ZodNullable<z.ZodString>;
                 verified_version: z.ZodNullable<z.ZodString>;
                 detail: z.ZodNullable<z.ZodString>;
+                recovery: z.ZodOptional<z.ZodObject<{
+                    operation: z.ZodObject<{
+                        operation_id: z.ZodUUID;
+                        baseline_revision: z.ZodString;
+                        target_revision: z.ZodString;
+                        stage: z.ZodEnum<{
+                            install: "install";
+                            gateway_restart: "gateway_restart";
+                            agent_ready: "agent_ready";
+                        }>;
+                        recovered_revision: z.ZodOptional<z.ZodString>;
+                        source_moved: z.ZodOptional<z.ZodBoolean>;
+                        attempt_error: z.ZodOptional<z.ZodString>;
+                        failed_stage: z.ZodOptional<z.ZodEnum<{
+                            install: "install";
+                            gateway_restart: "gateway_restart";
+                            agent_ready: "agent_ready";
+                        }>>;
+                    }, z.core.$strip>;
+                    attempt_error: z.ZodNullable<z.ZodString>;
+                    runtime_revision: z.ZodNullable<z.ZodString>;
+                    rollback: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                    outcome: z.ZodEnum<{
+                        unknown: "unknown";
+                        blocked: "blocked";
+                        recovering: "recovering";
+                        target_installed: "target_installed";
+                        baseline_restored: "baseline_restored";
+                        other_revision: "other_revision";
+                    }>;
+                }, z.core.$strip>>;
                 unread: z.ZodBoolean;
                 active: z.ZodBoolean;
                 requires_interaction: z.ZodBoolean;
                 can_dismiss: z.ZodBoolean;
                 steps: z.ZodArray<z.ZodObject<{
                     id: z.ZodEnum<{
-                        ready: "ready";
-                        gateway_restart: "gateway_restart";
                         install: "install";
+                        gateway_restart: "gateway_restart";
+                        agent_ready: "agent_ready";
+                        ready: "ready";
                         web_restart: "web_restart";
                         gateway_wait: "gateway_wait";
-                        agent_ready: "agent_ready";
+                        recovery: "recovery";
                     }>;
                     label: z.ZodString;
                     state: z.ZodEnum<{
@@ -1825,6 +2131,7 @@ export declare const toolsContract: {
                     awaiting_confirmation: "awaiting_confirmation";
                     waiting_for_idle: "waiting_for_idle";
                     verifying: "verifying";
+                    recovering: "recovering";
                     succeeded: "succeeded";
                 }>, z.ZodString]>;
                 severity: z.ZodEnum<{
@@ -1858,18 +2165,50 @@ export declare const toolsContract: {
                 verified_revision: z.ZodNullable<z.ZodString>;
                 verified_version: z.ZodNullable<z.ZodString>;
                 detail: z.ZodNullable<z.ZodString>;
+                recovery: z.ZodOptional<z.ZodObject<{
+                    operation: z.ZodObject<{
+                        operation_id: z.ZodUUID;
+                        baseline_revision: z.ZodString;
+                        target_revision: z.ZodString;
+                        stage: z.ZodEnum<{
+                            install: "install";
+                            gateway_restart: "gateway_restart";
+                            agent_ready: "agent_ready";
+                        }>;
+                        recovered_revision: z.ZodOptional<z.ZodString>;
+                        source_moved: z.ZodOptional<z.ZodBoolean>;
+                        attempt_error: z.ZodOptional<z.ZodString>;
+                        failed_stage: z.ZodOptional<z.ZodEnum<{
+                            install: "install";
+                            gateway_restart: "gateway_restart";
+                            agent_ready: "agent_ready";
+                        }>>;
+                    }, z.core.$strip>;
+                    attempt_error: z.ZodNullable<z.ZodString>;
+                    runtime_revision: z.ZodNullable<z.ZodString>;
+                    rollback: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                    outcome: z.ZodEnum<{
+                        unknown: "unknown";
+                        blocked: "blocked";
+                        recovering: "recovering";
+                        target_installed: "target_installed";
+                        baseline_restored: "baseline_restored";
+                        other_revision: "other_revision";
+                    }>;
+                }, z.core.$strip>>;
                 unread: z.ZodBoolean;
                 active: z.ZodBoolean;
                 requires_interaction: z.ZodBoolean;
                 can_dismiss: z.ZodBoolean;
                 steps: z.ZodArray<z.ZodObject<{
                     id: z.ZodEnum<{
-                        ready: "ready";
-                        gateway_restart: "gateway_restart";
                         install: "install";
+                        gateway_restart: "gateway_restart";
+                        agent_ready: "agent_ready";
+                        ready: "ready";
                         web_restart: "web_restart";
                         gateway_wait: "gateway_wait";
-                        agent_ready: "agent_ready";
+                        recovery: "recovery";
                     }>;
                     label: z.ZodString;
                     state: z.ZodEnum<{
@@ -1912,6 +2251,7 @@ export declare const toolsContract: {
                 awaiting_confirmation: "awaiting_confirmation";
                 waiting_for_idle: "waiting_for_idle";
                 verifying: "verifying";
+                recovering: "recovering";
                 succeeded: "succeeded";
             }>, z.ZodString]>;
             severity: z.ZodEnum<{
@@ -1945,18 +2285,50 @@ export declare const toolsContract: {
             verified_revision: z.ZodNullable<z.ZodString>;
             verified_version: z.ZodNullable<z.ZodString>;
             detail: z.ZodNullable<z.ZodString>;
+            recovery: z.ZodOptional<z.ZodObject<{
+                operation: z.ZodObject<{
+                    operation_id: z.ZodUUID;
+                    baseline_revision: z.ZodString;
+                    target_revision: z.ZodString;
+                    stage: z.ZodEnum<{
+                        install: "install";
+                        gateway_restart: "gateway_restart";
+                        agent_ready: "agent_ready";
+                    }>;
+                    recovered_revision: z.ZodOptional<z.ZodString>;
+                    source_moved: z.ZodOptional<z.ZodBoolean>;
+                    attempt_error: z.ZodOptional<z.ZodString>;
+                    failed_stage: z.ZodOptional<z.ZodEnum<{
+                        install: "install";
+                        gateway_restart: "gateway_restart";
+                        agent_ready: "agent_ready";
+                    }>>;
+                }, z.core.$strip>;
+                attempt_error: z.ZodNullable<z.ZodString>;
+                runtime_revision: z.ZodNullable<z.ZodString>;
+                rollback: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                outcome: z.ZodEnum<{
+                    unknown: "unknown";
+                    blocked: "blocked";
+                    recovering: "recovering";
+                    target_installed: "target_installed";
+                    baseline_restored: "baseline_restored";
+                    other_revision: "other_revision";
+                }>;
+            }, z.core.$strip>>;
             unread: z.ZodBoolean;
             active: z.ZodBoolean;
             requires_interaction: z.ZodBoolean;
             can_dismiss: z.ZodBoolean;
             steps: z.ZodArray<z.ZodObject<{
                 id: z.ZodEnum<{
-                    ready: "ready";
-                    gateway_restart: "gateway_restart";
                     install: "install";
+                    gateway_restart: "gateway_restart";
+                    agent_ready: "agent_ready";
+                    ready: "ready";
                     web_restart: "web_restart";
                     gateway_wait: "gateway_wait";
-                    agent_ready: "agent_ready";
+                    recovery: "recovery";
                 }>;
                 label: z.ZodString;
                 state: z.ZodEnum<{
@@ -2009,6 +2381,7 @@ export declare const toolsContract: {
                     awaiting_confirmation: "awaiting_confirmation";
                     waiting_for_idle: "waiting_for_idle";
                     verifying: "verifying";
+                    recovering: "recovering";
                     succeeded: "succeeded";
                 }>, z.ZodString]>;
                 severity: z.ZodEnum<{
@@ -2042,18 +2415,50 @@ export declare const toolsContract: {
                 verified_revision: z.ZodNullable<z.ZodString>;
                 verified_version: z.ZodNullable<z.ZodString>;
                 detail: z.ZodNullable<z.ZodString>;
+                recovery: z.ZodOptional<z.ZodObject<{
+                    operation: z.ZodObject<{
+                        operation_id: z.ZodUUID;
+                        baseline_revision: z.ZodString;
+                        target_revision: z.ZodString;
+                        stage: z.ZodEnum<{
+                            install: "install";
+                            gateway_restart: "gateway_restart";
+                            agent_ready: "agent_ready";
+                        }>;
+                        recovered_revision: z.ZodOptional<z.ZodString>;
+                        source_moved: z.ZodOptional<z.ZodBoolean>;
+                        attempt_error: z.ZodOptional<z.ZodString>;
+                        failed_stage: z.ZodOptional<z.ZodEnum<{
+                            install: "install";
+                            gateway_restart: "gateway_restart";
+                            agent_ready: "agent_ready";
+                        }>>;
+                    }, z.core.$strip>;
+                    attempt_error: z.ZodNullable<z.ZodString>;
+                    runtime_revision: z.ZodNullable<z.ZodString>;
+                    rollback: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                    outcome: z.ZodEnum<{
+                        unknown: "unknown";
+                        blocked: "blocked";
+                        recovering: "recovering";
+                        target_installed: "target_installed";
+                        baseline_restored: "baseline_restored";
+                        other_revision: "other_revision";
+                    }>;
+                }, z.core.$strip>>;
                 unread: z.ZodBoolean;
                 active: z.ZodBoolean;
                 requires_interaction: z.ZodBoolean;
                 can_dismiss: z.ZodBoolean;
                 steps: z.ZodArray<z.ZodObject<{
                     id: z.ZodEnum<{
-                        ready: "ready";
-                        gateway_restart: "gateway_restart";
                         install: "install";
+                        gateway_restart: "gateway_restart";
+                        agent_ready: "agent_ready";
+                        ready: "ready";
                         web_restart: "web_restart";
                         gateway_wait: "gateway_wait";
-                        agent_ready: "agent_ready";
+                        recovery: "recovery";
                     }>;
                     label: z.ZodString;
                     state: z.ZodEnum<{
@@ -2087,6 +2492,7 @@ export declare const toolsContract: {
                     awaiting_confirmation: "awaiting_confirmation";
                     waiting_for_idle: "waiting_for_idle";
                     verifying: "verifying";
+                    recovering: "recovering";
                     succeeded: "succeeded";
                 }>, z.ZodString]>;
                 severity: z.ZodEnum<{
@@ -2120,18 +2526,50 @@ export declare const toolsContract: {
                 verified_revision: z.ZodNullable<z.ZodString>;
                 verified_version: z.ZodNullable<z.ZodString>;
                 detail: z.ZodNullable<z.ZodString>;
+                recovery: z.ZodOptional<z.ZodObject<{
+                    operation: z.ZodObject<{
+                        operation_id: z.ZodUUID;
+                        baseline_revision: z.ZodString;
+                        target_revision: z.ZodString;
+                        stage: z.ZodEnum<{
+                            install: "install";
+                            gateway_restart: "gateway_restart";
+                            agent_ready: "agent_ready";
+                        }>;
+                        recovered_revision: z.ZodOptional<z.ZodString>;
+                        source_moved: z.ZodOptional<z.ZodBoolean>;
+                        attempt_error: z.ZodOptional<z.ZodString>;
+                        failed_stage: z.ZodOptional<z.ZodEnum<{
+                            install: "install";
+                            gateway_restart: "gateway_restart";
+                            agent_ready: "agent_ready";
+                        }>>;
+                    }, z.core.$strip>;
+                    attempt_error: z.ZodNullable<z.ZodString>;
+                    runtime_revision: z.ZodNullable<z.ZodString>;
+                    rollback: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                    outcome: z.ZodEnum<{
+                        unknown: "unknown";
+                        blocked: "blocked";
+                        recovering: "recovering";
+                        target_installed: "target_installed";
+                        baseline_restored: "baseline_restored";
+                        other_revision: "other_revision";
+                    }>;
+                }, z.core.$strip>>;
                 unread: z.ZodBoolean;
                 active: z.ZodBoolean;
                 requires_interaction: z.ZodBoolean;
                 can_dismiss: z.ZodBoolean;
                 steps: z.ZodArray<z.ZodObject<{
                     id: z.ZodEnum<{
-                        ready: "ready";
-                        gateway_restart: "gateway_restart";
                         install: "install";
+                        gateway_restart: "gateway_restart";
+                        agent_ready: "agent_ready";
+                        ready: "ready";
                         web_restart: "web_restart";
                         gateway_wait: "gateway_wait";
-                        agent_ready: "agent_ready";
+                        recovery: "recovery";
                     }>;
                     label: z.ZodString;
                     state: z.ZodEnum<{
@@ -2173,6 +2611,7 @@ export declare const toolsContract: {
                 awaiting_confirmation: "awaiting_confirmation";
                 waiting_for_idle: "waiting_for_idle";
                 verifying: "verifying";
+                recovering: "recovering";
                 succeeded: "succeeded";
             }>, z.ZodString]>;
             severity: z.ZodEnum<{
@@ -2206,18 +2645,50 @@ export declare const toolsContract: {
             verified_revision: z.ZodNullable<z.ZodString>;
             verified_version: z.ZodNullable<z.ZodString>;
             detail: z.ZodNullable<z.ZodString>;
+            recovery: z.ZodOptional<z.ZodObject<{
+                operation: z.ZodObject<{
+                    operation_id: z.ZodUUID;
+                    baseline_revision: z.ZodString;
+                    target_revision: z.ZodString;
+                    stage: z.ZodEnum<{
+                        install: "install";
+                        gateway_restart: "gateway_restart";
+                        agent_ready: "agent_ready";
+                    }>;
+                    recovered_revision: z.ZodOptional<z.ZodString>;
+                    source_moved: z.ZodOptional<z.ZodBoolean>;
+                    attempt_error: z.ZodOptional<z.ZodString>;
+                    failed_stage: z.ZodOptional<z.ZodEnum<{
+                        install: "install";
+                        gateway_restart: "gateway_restart";
+                        agent_ready: "agent_ready";
+                    }>>;
+                }, z.core.$strip>;
+                attempt_error: z.ZodNullable<z.ZodString>;
+                runtime_revision: z.ZodNullable<z.ZodString>;
+                rollback: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                outcome: z.ZodEnum<{
+                    unknown: "unknown";
+                    blocked: "blocked";
+                    recovering: "recovering";
+                    target_installed: "target_installed";
+                    baseline_restored: "baseline_restored";
+                    other_revision: "other_revision";
+                }>;
+            }, z.core.$strip>>;
             unread: z.ZodBoolean;
             active: z.ZodBoolean;
             requires_interaction: z.ZodBoolean;
             can_dismiss: z.ZodBoolean;
             steps: z.ZodArray<z.ZodObject<{
                 id: z.ZodEnum<{
-                    ready: "ready";
-                    gateway_restart: "gateway_restart";
                     install: "install";
+                    gateway_restart: "gateway_restart";
+                    agent_ready: "agent_ready";
+                    ready: "ready";
                     web_restart: "web_restart";
                     gateway_wait: "gateway_wait";
-                    agent_ready: "agent_ready";
+                    recovery: "recovery";
                 }>;
                 label: z.ZodString;
                 state: z.ZodEnum<{
@@ -2256,6 +2727,7 @@ export declare const toolsContract: {
                 awaiting_confirmation: "awaiting_confirmation";
                 waiting_for_idle: "waiting_for_idle";
                 verifying: "verifying";
+                recovering: "recovering";
                 succeeded: "succeeded";
             }>, z.ZodString]>;
             severity: z.ZodEnum<{
@@ -2289,18 +2761,50 @@ export declare const toolsContract: {
             verified_revision: z.ZodNullable<z.ZodString>;
             verified_version: z.ZodNullable<z.ZodString>;
             detail: z.ZodNullable<z.ZodString>;
+            recovery: z.ZodOptional<z.ZodObject<{
+                operation: z.ZodObject<{
+                    operation_id: z.ZodUUID;
+                    baseline_revision: z.ZodString;
+                    target_revision: z.ZodString;
+                    stage: z.ZodEnum<{
+                        install: "install";
+                        gateway_restart: "gateway_restart";
+                        agent_ready: "agent_ready";
+                    }>;
+                    recovered_revision: z.ZodOptional<z.ZodString>;
+                    source_moved: z.ZodOptional<z.ZodBoolean>;
+                    attempt_error: z.ZodOptional<z.ZodString>;
+                    failed_stage: z.ZodOptional<z.ZodEnum<{
+                        install: "install";
+                        gateway_restart: "gateway_restart";
+                        agent_ready: "agent_ready";
+                    }>>;
+                }, z.core.$strip>;
+                attempt_error: z.ZodNullable<z.ZodString>;
+                runtime_revision: z.ZodNullable<z.ZodString>;
+                rollback: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                outcome: z.ZodEnum<{
+                    unknown: "unknown";
+                    blocked: "blocked";
+                    recovering: "recovering";
+                    target_installed: "target_installed";
+                    baseline_restored: "baseline_restored";
+                    other_revision: "other_revision";
+                }>;
+            }, z.core.$strip>>;
             unread: z.ZodBoolean;
             active: z.ZodBoolean;
             requires_interaction: z.ZodBoolean;
             can_dismiss: z.ZodBoolean;
             steps: z.ZodArray<z.ZodObject<{
                 id: z.ZodEnum<{
-                    ready: "ready";
-                    gateway_restart: "gateway_restart";
                     install: "install";
+                    gateway_restart: "gateway_restart";
+                    agent_ready: "agent_ready";
+                    ready: "ready";
                     web_restart: "web_restart";
                     gateway_wait: "gateway_wait";
-                    agent_ready: "agent_ready";
+                    recovery: "recovery";
                 }>;
                 label: z.ZodString;
                 state: z.ZodEnum<{