@maudecode/talaria-web-contracts 1.19.0 → 1.20.0

package/dist/routes/tools.d.ts

@@ -78,9 +78,9 @@ export declare const toolsContract: {
                 load_name: z.ZodOptional<z.ZodString>;
                 declared_name: z.ZodOptional<z.ZodString>;
                 status: z.ZodOptional<z.ZodEnum<{
+                    shadowed: "shadowed";
                     unique: "unique";
                     ambiguous: "ambiguous";
-                    shadowed: "shadowed";
                 }>>;
                 tier: z.ZodOptional<z.ZodNumber>;
             }, z.core.$loose>>;
@@ -368,8 +368,8 @@ export declare const toolsContract: {
             enabled: z.ZodBoolean;
             status: z.ZodEnum<{
                 error: "error";
-                ready: "ready";
                 empty: "empty";
+                ready: "ready";
                 missing: "missing";
                 not_directory: "not_directory";
             }>;
@@ -558,14 +558,14 @@ export declare const toolsContract: {
                     binary: z.ZodOptional<z.ZodBoolean>;
                     mime: z.ZodOptional<z.ZodString>;
                     preview: z.ZodOptional<z.ZodEnum<{
+                        markdown: "markdown";
+                        html: "html";
                         text: "text";
                         image: "image";
                         audio: "audio";
                         video: "video";
                         pdf: "pdf";
-                        markdown: "markdown";
                         csv: "csv";
-                        html: "html";
                         binary: "binary";
                     }>>;
                     table: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString>>>;
@@ -581,14 +581,14 @@ export declare const toolsContract: {
                     binary: z.ZodOptional<z.ZodBoolean>;
                     mime: z.ZodOptional<z.ZodString>;
                     preview: z.ZodOptional<z.ZodEnum<{
+                        markdown: "markdown";
+                        html: "html";
                         text: "text";
                         image: "image";
                         audio: "audio";
                         video: "video";
                         pdf: "pdf";
-                        markdown: "markdown";
                         csv: "csv";
-                        html: "html";
                         binary: "binary";
                     }>>;
                     table: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString>>>;
@@ -604,14 +604,14 @@ export declare const toolsContract: {
                     binary: z.ZodOptional<z.ZodBoolean>;
                     mime: z.ZodOptional<z.ZodString>;
                     preview: z.ZodOptional<z.ZodEnum<{
+                        markdown: "markdown";
+                        html: "html";
                         text: "text";
                         image: "image";
                         audio: "audio";
                         video: "video";
                         pdf: "pdf";
-                        markdown: "markdown";
                         csv: "csv";
-                        html: "html";
                         binary: "binary";
                     }>>;
                     table: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString>>>;
@@ -627,14 +627,14 @@ export declare const toolsContract: {
                     binary: z.ZodOptional<z.ZodBoolean>;
                     mime: z.ZodOptional<z.ZodString>;
                     preview: z.ZodOptional<z.ZodEnum<{
+                        markdown: "markdown";
+                        html: "html";
                         text: "text";
                         image: "image";
                         audio: "audio";
                         video: "video";
                         pdf: "pdf";
-                        markdown: "markdown";
                         csv: "csv";
-                        html: "html";
                         binary: "binary";
                     }>>;
                     table: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString>>>;
@@ -859,6 +859,7 @@ export declare const toolsContract: {
         }, z.core.$strip>, Record<never, never>, Record<never, never>>;
         page: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, z.ZodObject<{
             available: z.ZodBoolean;
+            sign_in_required: z.ZodDefault<z.ZodBoolean>;
             connectors: z.ZodArray<z.ZodObject<{
                 slug: z.ZodString;
                 name: z.ZodString;
@@ -871,9 +872,9 @@ export declare const toolsContract: {
                     name: z.ZodString;
                     problem: z.ZodNullable<z.ZodEnum<{
                         pending: "pending";
-                        failed: "failed";
                         expired: "expired";
                         revoked: "revoked";
+                        failed: "failed";
                         inactive: "inactive";
                     }>>;
                     status_reason: z.ZodNullable<z.ZodString>;
@@ -936,11 +937,11 @@ export declare const toolsContract: {
                 kind: z.ZodString;
                 state: z.ZodEnum<{
                     pending: "pending";
+                    expired: "expired";
                     skipped: "skipped";
                     initiated: "initiated";
                     connected: "connected";
                     failed: "failed";
-                    expired: "expired";
                     not_connected: "not_connected";
                 }>;
                 detail: z.ZodString;
@@ -980,11 +981,11 @@ export declare const toolsContract: {
                 kind: z.ZodString;
                 state: z.ZodEnum<{
                     pending: "pending";
+                    expired: "expired";
                     skipped: "skipped";
                     initiated: "initiated";
                     connected: "connected";
                     failed: "failed";
-                    expired: "expired";
                     not_connected: "not_connected";
                 }>;
                 detail: z.ZodString;
@@ -1027,11 +1028,11 @@ export declare const toolsContract: {
                 kind: z.ZodString;
                 state: z.ZodEnum<{
                     pending: "pending";
+                    expired: "expired";
                     skipped: "skipped";
                     initiated: "initiated";
                     connected: "connected";
                     failed: "failed";
-                    expired: "expired";
                     not_connected: "not_connected";
                 }>;
                 detail: z.ZodString;
@@ -1061,6 +1062,10 @@ export declare const toolsContract: {
             activation: z.ZodOptional<z.ZodString>;
             is_active_provider: z.ZodOptional<z.ZodBoolean>;
             hooks: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+            update: z.ZodOptional<z.ZodObject<{
+                available: z.ZodBoolean;
+                latest_revision: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
             settings: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 key: z.ZodString;
                 type: z.ZodEnum<{
@@ -1081,6 +1086,18 @@ export declare const toolsContract: {
                 has_value: z.ZodOptional<z.ZodBoolean>;
                 locked: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>;
+            oauth_clients: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                state: z.ZodEnum<{
+                    signed_in: "signed_in";
+                    sign_in_needed: "sign_in_needed";
+                    revoked: "revoked";
+                    logged_out: "logged_out";
+                }>;
+                authorize_host: z.ZodString;
+                token_host: z.ZodString;
+                can_sign_out: z.ZodBoolean;
+            }, z.core.$strip>>>;
         }, z.core.$loose>>;
         empty: z.ZodOptional<z.ZodBoolean>;
         read_only: z.ZodOptional<z.ZodBoolean>;
@@ -1088,6 +1105,67 @@ export declare const toolsContract: {
         unavailable: z.ZodOptional<z.ZodBoolean>;
         plugin_isolation_advisory: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$loose>, Record<never, never>, Record<never, never>>;
+    pluginCatalog: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        query: z.ZodDefault<z.ZodString>;
+        offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+        supported: z.ZodBoolean;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        entries: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            repo: z.ZodString;
+            sha: z.ZodString;
+            tier: z.ZodString;
+            category: z.ZodString;
+            requirements: z.ZodArray<z.ZodString>;
+            installed_key: z.ZodNullable<z.ZodString>;
+            installed_sha: z.ZodNullable<z.ZodString>;
+            can_install: z.ZodBoolean;
+            refusal: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        total: z.ZodNumber;
+        next_offset: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>, Record<never, never>, Record<never, never>>;
+    pluginInstall: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        name: z.ZodString;
+        consent_token: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        name: z.ZodString;
+        key: z.ZodString;
+        status: z.ZodLiteral<"installed">;
+        enabled: z.ZodLiteral<false>;
+    }, z.core.$strip>, z.ZodObject<{
+        name: z.ZodString;
+        status: z.ZodLiteral<"needs_consent">;
+        findings: z.ZodString;
+        consent_token: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        name: z.ZodString;
+        status: z.ZodLiteral<"blocked">;
+        findings: z.ZodString;
+    }, z.core.$strip>], "status">, Record<never, never>, Record<never, never>>;
+    pluginUpdate: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        key: z.ZodString;
+        accept_caution: z.ZodDefault<z.ZodBoolean>;
+        consent_token: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        key: z.ZodString;
+        status: z.ZodLiteral<"updated">;
+    }, z.core.$strip>, z.ZodObject<{
+        key: z.ZodString;
+        status: z.ZodLiteral<"needs_consent">;
+        verdict: z.ZodLiteral<"caution">;
+        findings: z.ZodString;
+        consent_token: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        key: z.ZodString;
+        status: z.ZodLiteral<"blocked">;
+        verdict: z.ZodString;
+        findings: z.ZodString;
+    }, z.core.$strip>], "status">, Record<never, never>, Record<never, never>>;
     pluginSettings: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
         key: z.ZodString;
         values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1116,16 +1194,47 @@ export declare const toolsContract: {
             has_value: z.ZodOptional<z.ZodBoolean>;
             locked: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
+        runtime_application: z.ZodEnum<{
+            unknown: "unknown";
+            applied: "applied";
+            restart_required: "restart_required";
+        }>;
+    }, z.core.$strip>, Record<never, never>, Record<never, never>>;
+    pluginOAuthRedirect: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        flow_id: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodOptional<z.ZodBoolean>;
+        status: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        verification_url: z.ZodOptional<z.ZodString>;
+        user_code: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        flow_id: z.ZodOptional<z.ZodString>;
+        provider: z.ZodOptional<z.ZodString>;
+        expires_in: z.ZodOptional<z.ZodNumber>;
+        interval: z.ZodOptional<z.ZodNumber>;
+        authorize_host: z.ZodOptional<z.ZodString>;
+        token_host: z.ZodOptional<z.ZodString>;
+        redirect_uri: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>, Record<never, never>, Record<never, never>>;
+    pluginOAuthLogout: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        key: z.ZodString;
+        id: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        removed: z.ZodBoolean;
     }, z.core.$strip>, Record<never, never>, Record<never, never>>;
     updates: {
         check: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, z.ZodObject<{
             agent_recovery: z.ZodOptional<z.ZodObject<{
                 phase: z.ZodEnum<{
+                    blocked: "blocked";
                     running: "running";
                     waiting: "waiting";
                     idle: "idle";
                     complete: "complete";
-                    blocked: "blocked";
                 }>;
                 attempt: z.ZodNumber;
                 detail: z.ZodString;
@@ -1295,11 +1404,11 @@ export declare const toolsContract: {
         }, z.core.$strip>, z.ZodObject<{
             agent_recovery: z.ZodOptional<z.ZodObject<{
                 phase: z.ZodEnum<{
+                    blocked: "blocked";
                     running: "running";
                     waiting: "waiting";
                     idle: "idle";
                     complete: "complete";
-                    blocked: "blocked";
                 }>;
                 attempt: z.ZodNumber;
                 detail: z.ZodString;
@@ -1631,12 +1740,13 @@ export declare const toolsContract: {
                 }>>;
                 phase: z.ZodUnion<readonly [z.ZodEnum<{
                     unknown: "unknown";
-                    failed: "failed";
                     blocked: "blocked";
+                    restarting: "restarting";
+                    failed: "failed";
                     applying: "applying";
                     awaiting_confirmation: "awaiting_confirmation";
                     waiting_for_idle: "waiting_for_idle";
-                    restarting: "restarting";
+                    verifying: "verifying";
                     succeeded: "succeeded";
                 }>, z.ZodString]>;
                 severity: z.ZodEnum<{
@@ -1674,6 +1784,30 @@ export declare const toolsContract: {
                 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";
+                        web_restart: "web_restart";
+                        gateway_wait: "gateway_wait";
+                        agent_ready: "agent_ready";
+                    }>;
+                    label: z.ZodString;
+                    state: z.ZodEnum<{
+                        pending: "pending";
+                        active: "active";
+                        failed: "failed";
+                        done: "done";
+                    }>;
+                }, z.core.$strip>>;
+                presents_dialog: z.ZodBoolean;
+                dialog_close: z.ZodEnum<{
+                    auto: "auto";
+                    none: "none";
+                    close: "close";
+                    restart_later: "restart_later";
+                }>;
             }, z.core.$strip>>;
             tab_update: z.ZodNullable<z.ZodObject<{
                 id: z.ZodUUID;
@@ -1684,12 +1818,13 @@ export declare const toolsContract: {
                 }>>;
                 phase: z.ZodUnion<readonly [z.ZodEnum<{
                     unknown: "unknown";
-                    failed: "failed";
                     blocked: "blocked";
+                    restarting: "restarting";
+                    failed: "failed";
                     applying: "applying";
                     awaiting_confirmation: "awaiting_confirmation";
                     waiting_for_idle: "waiting_for_idle";
-                    restarting: "restarting";
+                    verifying: "verifying";
                     succeeded: "succeeded";
                 }>, z.ZodString]>;
                 severity: z.ZodEnum<{
@@ -1727,6 +1862,30 @@ export declare const toolsContract: {
                 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";
+                        web_restart: "web_restart";
+                        gateway_wait: "gateway_wait";
+                        agent_ready: "agent_ready";
+                    }>;
+                    label: z.ZodString;
+                    state: z.ZodEnum<{
+                        pending: "pending";
+                        active: "active";
+                        failed: "failed";
+                        done: "done";
+                    }>;
+                }, z.core.$strip>>;
+                presents_dialog: z.ZodBoolean;
+                dialog_close: z.ZodEnum<{
+                    auto: "auto";
+                    none: "none";
+                    close: "close";
+                    restart_later: "restart_later";
+                }>;
             }, z.core.$strip>>;
             tab_joined_at: z.ZodNullable<z.ZodISODateTime>;
             unread_count: z.ZodNumber;
@@ -1746,12 +1905,13 @@ export declare const toolsContract: {
             }>>;
             phase: z.ZodUnion<readonly [z.ZodEnum<{
                 unknown: "unknown";
-                failed: "failed";
                 blocked: "blocked";
+                restarting: "restarting";
+                failed: "failed";
                 applying: "applying";
                 awaiting_confirmation: "awaiting_confirmation";
                 waiting_for_idle: "waiting_for_idle";
-                restarting: "restarting";
+                verifying: "verifying";
                 succeeded: "succeeded";
             }>, z.ZodString]>;
             severity: z.ZodEnum<{
@@ -1789,6 +1949,30 @@ export declare const toolsContract: {
             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";
+                    web_restart: "web_restart";
+                    gateway_wait: "gateway_wait";
+                    agent_ready: "agent_ready";
+                }>;
+                label: z.ZodString;
+                state: z.ZodEnum<{
+                    pending: "pending";
+                    active: "active";
+                    failed: "failed";
+                    done: "done";
+                }>;
+            }, z.core.$strip>>;
+            presents_dialog: z.ZodBoolean;
+            dialog_close: z.ZodEnum<{
+                auto: "auto";
+                none: "none";
+                close: "close";
+                restart_later: "restart_later";
+            }>;
         }, z.core.$strip>, Record<never, never>, Record<never, never>>;
         dismiss: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
             id: z.ZodUUID;
@@ -1818,12 +2002,13 @@ export declare const toolsContract: {
                 }>>;
                 phase: z.ZodUnion<readonly [z.ZodEnum<{
                     unknown: "unknown";
-                    failed: "failed";
                     blocked: "blocked";
+                    restarting: "restarting";
+                    failed: "failed";
                     applying: "applying";
                     awaiting_confirmation: "awaiting_confirmation";
                     waiting_for_idle: "waiting_for_idle";
-                    restarting: "restarting";
+                    verifying: "verifying";
                     succeeded: "succeeded";
                 }>, z.ZodString]>;
                 severity: z.ZodEnum<{
@@ -1861,6 +2046,30 @@ export declare const toolsContract: {
                 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";
+                        web_restart: "web_restart";
+                        gateway_wait: "gateway_wait";
+                        agent_ready: "agent_ready";
+                    }>;
+                    label: z.ZodString;
+                    state: z.ZodEnum<{
+                        pending: "pending";
+                        active: "active";
+                        failed: "failed";
+                        done: "done";
+                    }>;
+                }, z.core.$strip>>;
+                presents_dialog: z.ZodBoolean;
+                dialog_close: z.ZodEnum<{
+                    auto: "auto";
+                    none: "none";
+                    close: "close";
+                    restart_later: "restart_later";
+                }>;
             }, z.core.$strip>>;
             tab_update: z.ZodNullable<z.ZodObject<{
                 id: z.ZodUUID;
@@ -1871,12 +2080,13 @@ export declare const toolsContract: {
                 }>>;
                 phase: z.ZodUnion<readonly [z.ZodEnum<{
                     unknown: "unknown";
-                    failed: "failed";
                     blocked: "blocked";
+                    restarting: "restarting";
+                    failed: "failed";
                     applying: "applying";
                     awaiting_confirmation: "awaiting_confirmation";
                     waiting_for_idle: "waiting_for_idle";
-                    restarting: "restarting";
+                    verifying: "verifying";
                     succeeded: "succeeded";
                 }>, z.ZodString]>;
                 severity: z.ZodEnum<{
@@ -1914,6 +2124,30 @@ export declare const toolsContract: {
                 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";
+                        web_restart: "web_restart";
+                        gateway_wait: "gateway_wait";
+                        agent_ready: "agent_ready";
+                    }>;
+                    label: z.ZodString;
+                    state: z.ZodEnum<{
+                        pending: "pending";
+                        active: "active";
+                        failed: "failed";
+                        done: "done";
+                    }>;
+                }, z.core.$strip>>;
+                presents_dialog: z.ZodBoolean;
+                dialog_close: z.ZodEnum<{
+                    auto: "auto";
+                    none: "none";
+                    close: "close";
+                    restart_later: "restart_later";
+                }>;
             }, z.core.$strip>>;
             tab_joined_at: z.ZodNullable<z.ZodISODateTime>;
             unread_count: z.ZodNumber;
@@ -1932,12 +2166,13 @@ export declare const toolsContract: {
             }>>;
             phase: z.ZodUnion<readonly [z.ZodEnum<{
                 unknown: "unknown";
-                failed: "failed";
                 blocked: "blocked";
+                restarting: "restarting";
+                failed: "failed";
                 applying: "applying";
                 awaiting_confirmation: "awaiting_confirmation";
                 waiting_for_idle: "waiting_for_idle";
-                restarting: "restarting";
+                verifying: "verifying";
                 succeeded: "succeeded";
             }>, z.ZodString]>;
             severity: z.ZodEnum<{
@@ -1975,6 +2210,30 @@ export declare const toolsContract: {
             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";
+                    web_restart: "web_restart";
+                    gateway_wait: "gateway_wait";
+                    agent_ready: "agent_ready";
+                }>;
+                label: z.ZodString;
+                state: z.ZodEnum<{
+                    pending: "pending";
+                    active: "active";
+                    failed: "failed";
+                    done: "done";
+                }>;
+            }, z.core.$strip>>;
+            presents_dialog: z.ZodBoolean;
+            dialog_close: z.ZodEnum<{
+                auto: "auto";
+                none: "none";
+                close: "close";
+                restart_later: "restart_later";
+            }>;
         }, z.core.$strip>, Record<never, never>, Record<never, never>>;
         action: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
             id: z.ZodUUID;
@@ -1990,12 +2249,13 @@ export declare const toolsContract: {
             }>>;
             phase: z.ZodUnion<readonly [z.ZodEnum<{
                 unknown: "unknown";
-                failed: "failed";
                 blocked: "blocked";
+                restarting: "restarting";
+                failed: "failed";
                 applying: "applying";
                 awaiting_confirmation: "awaiting_confirmation";
                 waiting_for_idle: "waiting_for_idle";
-                restarting: "restarting";
+                verifying: "verifying";
                 succeeded: "succeeded";
             }>, z.ZodString]>;
             severity: z.ZodEnum<{
@@ -2033,6 +2293,30 @@ export declare const toolsContract: {
             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";
+                    web_restart: "web_restart";
+                    gateway_wait: "gateway_wait";
+                    agent_ready: "agent_ready";
+                }>;
+                label: z.ZodString;
+                state: z.ZodEnum<{
+                    pending: "pending";
+                    active: "active";
+                    failed: "failed";
+                    done: "done";
+                }>;
+            }, z.core.$strip>>;
+            presents_dialog: z.ZodBoolean;
+            dialog_close: z.ZodEnum<{
+                auto: "auto";
+                none: "none";
+                close: "close";
+                restart_later: "restart_later";
+            }>;
         }, z.core.$strip>, Record<never, never>, Record<never, never>>;
     };
     transcribeCapability: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, z.ZodObject<{

package/dist/routes/tools.js

@@ -1,7 +1,7 @@
 import { oc } from '@orpc/contract';
 import { z } from 'zod';
-import { SkillsSchema, SkillContentSchema, SkillsUsageSchema, MemorySchema, PromptSchema, PromptsSchema, CommandsSchema, LogsSchema, InsightsSchema, AgentHealthSchema, SystemHealthSchema, McpServerSchema, McpServersSchema, McpToolsSchema, ConnectorsPageSchema, ConnectorToolsViewSchema, ConnectorOperationViewSchema, PluginsSchema, UpdatesCheckSchema, UpdatesSummarySchema, UpdateApplySchema, UpdateNotificationsSchema, UpdateNotificationSchema, TabIdSchema, FrontendBuildIdSchema, NotesSourcesSchema, NotesSearchSchema, NoteItemSchema, WikiStatusSchema, WikiBrowseSchema, WikiPageSchema, DashboardStatusSchema, DashboardConfigSchema, GatewayStatusSchema, GatewayActionSchema, ProjectOsDashboardSchema, TranscribeCapabilitySchema, SpeechPrepareSchema, PluginSettingViewSchema } from '../views.js';
-import { ToolsetsCatalogSchema, CommandBundleInvocationSchema, CommandBundleSchema, PendingWriteSchema, PendingWriteRefSchema } from '../sidecar/namespaces.js';
+import { SkillsSchema, SkillContentSchema, SkillsUsageSchema, MemorySchema, PromptSchema, PromptsSchema, CommandsSchema, LogsSchema, InsightsSchema, AgentHealthSchema, SystemHealthSchema, McpServerSchema, McpServersSchema, McpToolsSchema, ConnectorsPageSchema, ConnectorToolsViewSchema, ConnectorOperationViewSchema, PluginsSchema, UpdatesCheckSchema, UpdatesSummarySchema, UpdateApplySchema, UpdateNotificationsSchema, UpdateNotificationSchema, TabIdSchema, FrontendBuildIdSchema, NotesSourcesSchema, NotesSearchSchema, NoteItemSchema, WikiStatusSchema, WikiBrowseSchema, WikiPageSchema, DashboardStatusSchema, DashboardConfigSchema, GatewayStatusSchema, GatewayActionSchema, ProjectOsDashboardSchema, TranscribeCapabilitySchema, SpeechPrepareSchema, PluginSettingViewSchema, OnboardingOAuthSchema } from '../views.js';
+import { PluginCatalogQuerySchema, PluginCatalogSchema, PluginInstallInputSchema, PluginInstallResultSchema, PluginRuntimeApplicationSchema, PluginUpdateResultSchema, ToolsetsCatalogSchema, CommandBundleInvocationSchema, CommandBundleSchema, PendingWriteSchema, PendingWriteRefSchema } from '../sidecar/namespaces.js';
 /** Skills, memory, prompts, commands, notes, insights, logs, health, MCP, plugins, updates, and diagnostics. */
 const Json = z.unknown();
 const Loose = z.record(z.string(), z.unknown());
@@ -120,9 +120,19 @@ export const toolsContract = {
         respond: oc.route({ method: 'POST', path: '/api/connectors/operations/{op_id}', tags, summary: '`skip`, `retry` or `approve` (with `env`) one `target`, as its `actions` allow, or `continue` the card without the rest.' }).input(z.object({ op_id: z.string().min(1), action: z.enum(['skip', 'retry', 'approve', 'continue']), target: z.string().optional(), env: z.record(z.string(), z.string()).optional() })).output(ConnectorOperationViewSchema),
     },
     plugins: oc.route({ method: 'GET', path: '/api/plugins', tags }).output(PluginsSchema),
-    pluginSettings: oc.route({ method: 'POST', path: '/api/plugins/settings', tags, summary: 'TAL-806 (operator only): save a plugin\'s manifest-declared settings. `values` holds non-secret fields as the form entered them (numbers and JSON as text); the server checks each against the field list, writes the changed ones to `plugins.entries.<key>.settings`, and writes `secrets` to the profile `.env` under each field\'s `env` name (an empty one removes it). Secrets are written first; when a later write is refused, the ones already written are restored. 400 for an undeclared key, a bad value or a `locked` secret; 409 when the manifest changed; 503 when the Agent sidecar stopped before confirming (secrets stay written); 403 on a managed install, 404 for an unknown plugin.' })
+    pluginCatalog: oc.route({ method: 'GET', path: '/api/plugins/catalog', tags }).input(PluginCatalogQuerySchema).output(PluginCatalogSchema),
+    pluginInstall: oc.route({ method: 'POST', path: '/api/plugins/install', tags, summary: 'Operator only: preview or confirm a reviewed catalog pin. Confirmation is single use and binds the profile, catalog entry and staged tree. Native scan and admission apply; no replacement, dependency approval, enabling or Desktop UI grant.' })
+        .input(PluginInstallInputSchema).output(PluginInstallResultSchema),
+    pluginUpdate: oc.route({ method: 'POST', path: '/api/plugins/update', tags, summary: 'Operator only: update a profile-installed Git plugin through the Agent scan transaction. Caution requires accept_caution plus the single-use consent_token bound to the profile, installation and scanned revision; changed or expired consent returns 409. Dangerous always blocks.' })
+        .input(z.object({ key: z.string().trim().min(1), accept_caution: z.boolean().default(false), consent_token: z.string().min(1).max(128).optional() }))
+        .output(PluginUpdateResultSchema),
+    pluginSettings: oc.route({ method: 'POST', path: '/api/plugins/settings', tags, summary: 'TAL-806 (operator only): save a plugin\'s manifest-declared settings. `values` holds non-secret fields as the form entered them (numbers and JSON as text); the server checks each against the field list, writes the changed ones to `plugins.entries.<key>.settings`, and writes `secrets` to the profile `.env` under each field\'s `env` name (an empty one removes it). Secrets are written first; when a later write is refused, the ones already written are restored. 400 for an undeclared key, a bad value or a `locked` secret; 409 when the manifest changed; 503 when the Agent sidecar stopped before confirming (secrets stay written); 403 on a managed install, 404 for an unknown plugin. After persistence, runtime_application separately reports applied, restart_required, or unknown; runtime reconnect failures never roll saved secrets back.' })
         .input(z.object({ key: z.string().min(1), values: z.record(z.string(), Json).optional(), secrets: z.record(z.string(), z.string()).optional() }))
-        .output(z.object({ ok: z.literal(true), key: z.string(), written: z.array(z.string()), settings: z.array(PluginSettingViewSchema) })),
+        .output(z.object({ ok: z.literal(true), key: z.string(), written: z.array(z.string()), settings: z.array(PluginSettingViewSchema), runtime_application: PluginRuntimeApplicationSchema })),
+    pluginOAuthRedirect: oc.route({ method: 'POST', path: '/api/plugins/oauth/redirect', tags, summary: 'TAL-1276 (operator only): finish a plugin client\'s browser sign-in with `url`, the address the browser showed after the approval, when that address does not open on the Agent\'s machine. 400 `oauth_redirect_invalid` unless it is the flow\'s `redirect_uri` on 127.0.0.1 with the flow\'s `state`; 404 for an unknown flow, 409 `oauth_flow_ended` once it ended. Poll the flow afterwards.' })
+        .input(z.object({ flow_id: z.string().min(1), url: z.string().min(1) })).output(OnboardingOAuthSchema),
+    pluginOAuthLogout: oc.route({ method: 'POST', path: '/api/plugins/oauth/logout', tags, summary: 'TAL-1276 (operator only): sign out of a plugin-declared OAuth client (`hermes auth logout <key>:<id>`). `removed` is false when no grant was stored.' })
+        .input(z.object({ key: z.string().min(1), id: z.string().min(1) })).output(z.object({ ok: z.literal(true), removed: z.boolean() })),
     updates: {
         check: oc.route({ method: 'GET', path: '/api/updates/check', tags, summary: 'Cached status; `POST` runs the check. Git source installs can update from completed releases (stable) or origin/main (experimental); direct global npm installs can update to completed stable npm releases.' }).output(UpdatesCheckSchema),
         checkNow: oc.route({ method: 'POST', path: '/api/updates/check', tags }).input(z.object({ force: Json.optional(), channel: z.string().nullable().optional(), agent_channel: AgentOptions.agent_channel })).output(UpdatesCheckSchema),