@tai42/studio-sdk 25.0.0 → 26.0.0

package/dist/hooks/useApi.d.ts

@@ -83,7 +83,7 @@ export declare const ApiProvider: import("react").Provider<{
                     base: string;
                     paths: {
                         path: string;
-                        methods: ("GET" | "DELETE" | "PATCH" | "POST" | "PUT")[];
+                        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
                         public: boolean;
                     }[];
                 } | null | undefined;
@@ -131,7 +131,7 @@ export declare const ApiProvider: import("react").Provider<{
             conflict_path: string;
             full_path: string;
             item: string;
-            methods: ("GET" | "DELETE" | "PATCH" | "POST" | "PUT")[];
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
         }[];
         delivery: "package" | "descriptor";
         items: {
@@ -141,7 +141,7 @@ export declare const ApiProvider: import("react").Provider<{
             kind: string;
             routes: {
                 full_path: string;
-                methods: ("GET" | "DELETE" | "PATCH" | "POST" | "PUT")[];
+                methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
                 path: string;
                 public: boolean;
             }[];
@@ -150,12 +150,12 @@ export declare const ApiProvider: import("react").Provider<{
         new_public_routes: {
             full_path: string;
             item: string;
-            methods: ("GET" | "DELETE" | "PATCH" | "POST" | "PUT")[];
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
         }[];
         public_routes: {
             full_path: string;
             item: string;
-            methods: ("GET" | "DELETE" | "PATCH" | "POST" | "PUT")[];
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
         }[];
         ref: string;
         required_env: {
@@ -170,27 +170,28 @@ export declare const ApiProvider: import("react").Provider<{
         package: string | null;
         pip_output: string | null;
         ref: string;
+        routes: {
+            full_path: string;
+            item: string;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            public: boolean;
+        }[];
+        version: string;
+        advisories: {
+            id: number;
+            listing: string;
+            affected_versions: string;
+            severity: string;
+            summary: string;
+            created_at: string;
+            withdrawn_at: string | null;
+        }[];
         reload: {
             awaiting_respawn: {
                 keys: string[];
                 name: string;
             }[];
             env_keys: number;
-            fanout: {
-                error: string | null;
-                local_only: boolean | null;
-                mode: string;
-                note: string | null;
-                op: string | null;
-                reachable: boolean | null;
-                results: {
-                    detail: string | null;
-                    error: string | null;
-                    name: string;
-                    outcome: string;
-                    payload: unknown;
-                }[] | null;
-            };
             recycle: {
                 fresh: {
                     generation: number;
@@ -210,49 +211,50 @@ export declare const ApiProvider: import("react").Provider<{
                     name: string | null;
                 } | null;
             } | null;
+            span_release_error: string | null;
             status: string;
+            fanout: {
+                mode: "local-only";
+                note: string;
+            } | {
+                error: string | null;
+                local_only: boolean;
+                op: string;
+                reachable: boolean;
+                results: {
+                    detail: string | null;
+                    error: string | null;
+                    name: string;
+                    outcome: "failed" | "applied" | "missing" | "departed" | "timed_out" | "resyncing" | "recycling" | "stale";
+                    payload: unknown;
+                }[];
+                mode: "fleet";
+            } | {
+                error: string | null;
+                local_only: boolean;
+                op: string;
+                reachable: boolean;
+                results: {
+                    detail: string | null;
+                    error: string | null;
+                    name: string;
+                    outcome: "failed" | "applied" | "missing" | "departed" | "timed_out" | "resyncing" | "recycling" | "stale";
+                    payload: unknown;
+                }[];
+                mode: "unreachable";
+            };
         };
-        routes: {
-            full_path: string;
-            item: string;
-            methods: ("GET" | "DELETE" | "PATCH" | "POST" | "PUT")[];
-            public: boolean;
-        }[];
-        version: string;
-        advisories: {
-            id: number;
-            listing: string;
-            affected_versions: string;
-            severity: string;
-            summary: string;
-            created_at: string;
-            withdrawn_at: string | null;
-        }[];
     }>;
     readonly uninstallMarketplacePlugin: (body: import("@tai42/api-client").MarketplaceUninstallBody) => Promise<{
         notes: string[];
         ref: string;
+        uninstalled: boolean;
         reload: {
             awaiting_respawn: {
                 keys: string[];
                 name: string;
             }[];
             env_keys: number;
-            fanout: {
-                error: string | null;
-                local_only: boolean | null;
-                mode: string;
-                note: string | null;
-                op: string | null;
-                reachable: boolean | null;
-                results: {
-                    detail: string | null;
-                    error: string | null;
-                    name: string;
-                    outcome: string;
-                    payload: unknown;
-                }[] | null;
-            };
             recycle: {
                 fresh: {
                     generation: number;
@@ -272,36 +274,67 @@ export declare const ApiProvider: import("react").Provider<{
                     name: string | null;
                 } | null;
             } | null;
+            span_release_error: string | null;
             status: string;
+            fanout: {
+                mode: "local-only";
+                note: string;
+            } | {
+                error: string | null;
+                local_only: boolean;
+                op: string;
+                reachable: boolean;
+                results: {
+                    detail: string | null;
+                    error: string | null;
+                    name: string;
+                    outcome: "failed" | "applied" | "missing" | "departed" | "timed_out" | "resyncing" | "recycling" | "stale";
+                    payload: unknown;
+                }[];
+                mode: "fleet";
+            } | {
+                error: string | null;
+                local_only: boolean;
+                op: string;
+                reachable: boolean;
+                results: {
+                    detail: string | null;
+                    error: string | null;
+                    name: string;
+                    outcome: "failed" | "applied" | "missing" | "departed" | "timed_out" | "resyncing" | "recycling" | "stale";
+                    payload: unknown;
+                }[];
+                mode: "unreachable";
+            };
         } | null;
-        uninstalled: boolean;
     }>;
     readonly updateMarketplacePlugin: (body: import("@tai42/api-client").MarketplaceInstallBody) => Promise<{
         notes: string[];
         package: string | null;
         pip_output: string | null;
         ref: string;
+        routes: {
+            full_path: string;
+            item: string;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            public: boolean;
+        }[];
+        version: string;
+        advisories: {
+            id: number;
+            listing: string;
+            affected_versions: string;
+            severity: string;
+            summary: string;
+            created_at: string;
+            withdrawn_at: string | null;
+        }[];
         reload: {
             awaiting_respawn: {
                 keys: string[];
                 name: string;
             }[];
             env_keys: number;
-            fanout: {
-                error: string | null;
-                local_only: boolean | null;
-                mode: string;
-                note: string | null;
-                op: string | null;
-                reachable: boolean | null;
-                results: {
-                    detail: string | null;
-                    error: string | null;
-                    name: string;
-                    outcome: string;
-                    payload: unknown;
-                }[] | null;
-            };
             recycle: {
                 fresh: {
                     generation: number;
@@ -321,30 +354,46 @@ export declare const ApiProvider: import("react").Provider<{
                     name: string | null;
                 } | null;
             } | null;
+            span_release_error: string | null;
             status: string;
+            fanout: {
+                mode: "local-only";
+                note: string;
+            } | {
+                error: string | null;
+                local_only: boolean;
+                op: string;
+                reachable: boolean;
+                results: {
+                    detail: string | null;
+                    error: string | null;
+                    name: string;
+                    outcome: "failed" | "applied" | "missing" | "departed" | "timed_out" | "resyncing" | "recycling" | "stale";
+                    payload: unknown;
+                }[];
+                mode: "fleet";
+            } | {
+                error: string | null;
+                local_only: boolean;
+                op: string;
+                reachable: boolean;
+                results: {
+                    detail: string | null;
+                    error: string | null;
+                    name: string;
+                    outcome: "failed" | "applied" | "missing" | "departed" | "timed_out" | "resyncing" | "recycling" | "stale";
+                    payload: unknown;
+                }[];
+                mode: "unreachable";
+            };
         };
-        routes: {
-            full_path: string;
-            item: string;
-            methods: ("GET" | "DELETE" | "PATCH" | "POST" | "PUT")[];
-            public: boolean;
-        }[];
-        version: string;
-        advisories: {
-            id: number;
-            listing: string;
-            affected_versions: string;
-            severity: string;
-            summary: string;
-            created_at: string;
-            withdrawn_at: string | null;
-        }[];
     }>;
     readonly upgradeAllMarketplacePlugins: () => Promise<{
         results: {
             detail: string;
             outcome: "failed" | "upgraded" | "up-to-date" | "no-compatible-version";
             ref: string;
+            span_release_error: string | null;
         }[];
     }>;
     readonly getMarketplaceAdvisories: (signal?: AbortSignal) => Promise<{
@@ -394,7 +443,7 @@ export declare const ApiProvider: import("react").Provider<{
             inputPreview: unknown;
             latencyMs: number | null;
             outputPreview: unknown;
-            status: "error" | "success";
+            status: "success" | "error";
             tags: string[];
             totalTokens: number | null;
             traceId: string;
@@ -460,7 +509,7 @@ export declare const ApiProvider: import("react").Provider<{
     readonly getResolvedSpanValue: (traceId: string, spanId: string, field: "input" | "output", options?: {
         readonly pointer?: string;
     }, signal?: AbortSignal) => Promise<{
-        field: "output" | "input";
+        field: "input" | "output";
         pointer: string;
         spanId: string;
         traceId: string;
@@ -540,6 +589,7 @@ export declare const ApiProvider: import("react").Provider<{
                 } | null;
             } | null;
             skipped: number;
+            span_release_error: string | null;
             updated: number;
             fanout: {
                 mode: "local-only";
@@ -666,6 +716,7 @@ export declare const ApiProvider: import("react").Provider<{
         owner_user_id: string;
     }>;
     readonly getMe: (signal?: AbortSignal) => Promise<{
+        access_control_enabled: boolean;
         admin: boolean;
         agents: string[];
         mintable: boolean;
@@ -910,6 +961,7 @@ export declare const ApiProvider: import("react").Provider<{
         mapped: string | null;
         methods: string[];
         path: string;
+        role_reach: "public" | "level" | "self_service" | "admin_only" | null;
         summary: string;
         tags: string[];
     }[]>;
@@ -1047,7 +1099,7 @@ export declare const ApiProvider: import("react").Provider<{
                     kwargs?: Record<string, unknown> | undefined;
                 };
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             } | null;
             tool: string;
@@ -1208,7 +1260,7 @@ export declare const ApiProvider: import("react").Provider<{
                 id?: string | undefined;
                 kwargs?: Record<string, unknown> | undefined;
             } | null;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
             turns_per_hour_override: number | null;
         } | {
@@ -1265,7 +1317,7 @@ export declare const ApiProvider: import("react").Provider<{
                 id?: string | undefined;
                 kwargs?: Record<string, unknown> | undefined;
             } | null;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
             turns_per_hour_override: number | null;
         })[];
@@ -1329,7 +1381,7 @@ export declare const ApiProvider: import("react").Provider<{
                 id?: string | undefined;
                 kwargs?: Record<string, unknown> | undefined;
             } | null;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
             turns_per_hour_override: number | null;
         } | {
@@ -1386,7 +1438,7 @@ export declare const ApiProvider: import("react").Provider<{
                 id?: string | undefined;
                 kwargs?: Record<string, unknown> | undefined;
             } | null;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
             turns_per_hour_override: number | null;
         };
@@ -1940,7 +1992,7 @@ export declare const ApiProvider: import("react").Provider<{
                     }[];
                 }[];
             } | null;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
         }[];
         total: number;
@@ -1992,7 +2044,7 @@ export declare const ApiProvider: import("react").Provider<{
                 }[];
             }[];
         } | null;
-        target_kind: "tool" | "agent";
+        target_kind: "agent" | "tool";
         target_name: string;
     }>;
     readonly setConversationConfig: (config: import("@tai42/api-client").TargetConversationConfig) => Promise<{
@@ -2042,16 +2094,16 @@ export declare const ApiProvider: import("react").Provider<{
                     }[];
                 }[];
             } | null;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
         };
         created: boolean;
-        target_kind: "tool" | "agent";
+        target_kind: "agent" | "tool";
         target_name: string;
     }>;
     readonly deleteConversationConfig: (targetKind: import("@tai42/api-client").ConversationTargetKind, targetName: string) => Promise<{
         removed: boolean;
-        target_kind: "tool" | "agent";
+        target_kind: "agent" | "tool";
         target_name: string;
     }>;
     readonly listFailedConversationMessages: (signal?: AbortSignal) => Promise<{
@@ -2298,7 +2350,10 @@ export declare const ApiProvider: import("react").Provider<{
         states_erased: number;
     }>;
     readonly listChannels: (signal?: AbortSignal) => Promise<{
-        channels: string[];
+        channels: {
+            identity_hint: string | null;
+            name: string;
+        }[];
     }>;
     readonly listInteractions: (page: number, pageSize: number, signal?: AbortSignal) => Promise<{
         next_page: number | null;
@@ -2307,7 +2362,7 @@ export declare const ApiProvider: import("react").Provider<{
         total: number;
         truncated: boolean;
         items: {
-            answer_format: "text" | "free" | "confirm" | "form" | "select" | "external";
+            answer_format: "free" | "confirm" | "form" | "text" | "select" | "external";
             audience: string | null;
             channel: string | null;
             created_at: string;
@@ -2400,6 +2455,7 @@ export declare const ApiProvider: import("react").Provider<{
                 scopes: string[];
             }[];
         };
+        span_release_error: string | null;
         fanout: {
             mode: "local-only";
             note: string;
@@ -2434,6 +2490,7 @@ export declare const ApiProvider: import("react").Provider<{
     readonly removeProvider: (id: string) => Promise<{
         provider_id: string;
         removed_clients: number;
+        span_release_error: string | null;
         fanout: {
             mode: "local-only";
             note: string;
@@ -2490,6 +2547,7 @@ export declare const ApiProvider: import("react").Provider<{
                 scopes: string[];
             }[];
         };
+        span_release_error: string | null;
         fanout: {
             mode: "local-only";
             note: string;
@@ -2588,6 +2646,7 @@ export declare const ApiProvider: import("react").Provider<{
     } | {
         added_manifest_entries: string[];
         connection_id: string;
+        span_release_error: string | null;
         fanout: {
             mode: "local-only";
             note: string;
@@ -2622,6 +2681,7 @@ export declare const ApiProvider: import("react").Provider<{
     readonly disconnect: (id: string) => Promise<{
         connection_id: string;
         removed_manifest_entries: string[];
+        span_release_error: string | null;
         upstream_revoke_outcome: "success" | "failed" | "skipped";
         upstream_revoke_status: number | null;
         fanout: {
@@ -2667,6 +2727,7 @@ export declare const ApiProvider: import("react").Provider<{
         enabled_sub_services: string[];
         flow_id: string | null;
         removed_manifest_entries: string[];
+        span_release_error: string | null;
         fanout: {
             mode: "local-only";
             note: string;
@@ -2710,6 +2771,7 @@ export declare const ApiProvider: import("react").Provider<{
         connection_id: string;
         kind: "success";
         return_url: string;
+        span_release_error: string | null;
         fanout: {
             mode: "local-only";
             note: string;
@@ -2766,6 +2828,7 @@ export declare const ApiProvider: import("react").Provider<{
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -2808,6 +2871,28 @@ export declare const ApiProvider: import("react").Provider<{
                 sub_service: string;
             } | null | undefined;
         }[];
+        extension_settings: {
+            backend_module: string | null;
+            extensions_modules: string[];
+            tools: {
+                title: string;
+                extensions: Record<string, (string | {
+                    name: string;
+                    config: Record<string, unknown>;
+                })[][]>;
+            }[];
+            mcp: {
+                title: string;
+                extensions: Record<string, (string | {
+                    name: string;
+                    config: Record<string, unknown>;
+                })[][]>;
+            }[];
+            api_tools: Record<string, (string | {
+                name: string;
+                config: Record<string, unknown>;
+            })[][]>;
+        };
     }>;
     readonly getMcpEnvRefs: (signal?: AbortSignal) => Promise<{
         has_default: boolean;
@@ -2866,6 +2951,7 @@ export declare const ApiProvider: import("react").Provider<{
             name: string | null;
         } | null;
         refused: string[];
+        span_release_error: string | null;
         fanout: {
             mode: "local-only";
             note: string;
@@ -2950,6 +3036,7 @@ export declare const ApiProvider: import("react").Provider<{
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3015,18 +3102,37 @@ export declare const ApiProvider: import("react").Provider<{
         removed: boolean;
         slug: string;
     }>;
-    readonly getManifest: (signal?: AbortSignal) => Promise<{
-        user_tools: string[];
-        mcp: {
-            [x: string]: unknown;
-            managed?: {
-                connection_id: string;
-                provider_id: string;
-                sub_service: string;
-            } | null | undefined;
+    readonly getMcpStatus: (signal?: AbortSignal) => Promise<{
+        bound: Record<string, string[]>;
+        failed: {
+            category: string;
+            http_status: number | null;
+            message: string;
+            status: string;
+            title: string;
         }[];
+        health: Record<string, {
+            consecutive_failures: number;
+            failing_since: string | null;
+            last_error: Record<string, string> | null;
+            last_success: string | null;
+        }>;
     }>;
-    readonly setMcpConfig: (mcp: unknown[]) => Promise<{
+    readonly listMcpAdvertisedTools: (title: string, signal?: AbortSignal) => Promise<{
+        exclude: string[];
+        include: string[];
+        title: string;
+        tools: {
+            bound: boolean;
+            description: string | null;
+            name: string;
+            selected: boolean;
+            title: string | null;
+            unbound_reason: "server_failed" | "not_loaded" | "preset_conflict" | "unusable_schema" | "not_listed_at_bind" | null;
+        }[];
+        unadvertised: string[];
+    }>;
+    readonly setMcpToolFilter: (title: string, filter: import("@tai42/api-client").McpToolFilter) => Promise<{
         awaiting_respawn: {
             keys: string[];
             name: string;
@@ -3051,6 +3157,7 @@ export declare const ApiProvider: import("react").Provider<{
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3083,23 +3190,21 @@ export declare const ApiProvider: import("react").Provider<{
             mode: "unreachable";
         };
     }>;
-    readonly getMcpStatus: (signal?: AbortSignal) => Promise<{
-        bound: Record<string, string[]>;
-        failed: {
-            category: string;
-            http_status: number | null;
-            message: string;
-            status: string;
-            title: string;
+    readonly reloadMcp: (title: string) => Promise<{
+        error: string | null;
+        local_only: boolean;
+        ok: boolean;
+        op: string;
+        reachable: boolean;
+        results: {
+            detail: string | null;
+            error: string | null;
+            name: string;
+            outcome: "failed" | "applied" | "missing" | "departed" | "timed_out" | "resyncing" | "recycling" | "stale";
+            payload: unknown;
         }[];
-        health: Record<string, {
-            consecutive_failures: number;
-            failing_since: string | null;
-            last_error: Record<string, string> | null;
-            last_success: string | null;
-        }>;
     }>;
-    readonly reloadMcp: (title: string) => Promise<{
+    readonly listFailedMcps: (signal?: AbortSignal) => Promise<{
         error: string | null;
         local_only: boolean;
         ok: boolean;
@@ -3113,7 +3218,68 @@ export declare const ApiProvider: import("react").Provider<{
             payload: unknown;
         }[];
     }>;
-    readonly addToolsEntries: (entries: readonly unknown[], replace?: boolean) => Promise<{
+    readonly reloadFailedMcps: () => Promise<{
+        error: string | null;
+        local_only: boolean;
+        ok: boolean;
+        op: string;
+        reachable: boolean;
+        results: {
+            detail: string | null;
+            error: string | null;
+            name: string;
+            outcome: "failed" | "applied" | "missing" | "departed" | "timed_out" | "resyncing" | "recycling" | "stale";
+            payload: unknown;
+        }[];
+    }>;
+    readonly deregisterMcp: (title: string) => Promise<{
+        error: string | null;
+        local_only: boolean;
+        ok: boolean;
+        op: string;
+        reachable: boolean;
+        results: {
+            detail: string | null;
+            error: string | null;
+            name: string;
+            outcome: "failed" | "applied" | "missing" | "departed" | "timed_out" | "resyncing" | "recycling" | "stale";
+            payload: unknown;
+        }[];
+    }>;
+    readonly getManifest: (signal?: AbortSignal) => Promise<{
+        user_tools: string[];
+        mcp: {
+            [x: string]: unknown;
+            managed?: {
+                connection_id: string;
+                provider_id: string;
+                sub_service: string;
+            } | null | undefined;
+        }[];
+        extension_settings: {
+            backend_module: string | null;
+            extensions_modules: string[];
+            tools: {
+                title: string;
+                extensions: Record<string, (string | {
+                    name: string;
+                    config: Record<string, unknown>;
+                })[][]>;
+            }[];
+            mcp: {
+                title: string;
+                extensions: Record<string, (string | {
+                    name: string;
+                    config: Record<string, unknown>;
+                })[][]>;
+            }[];
+            api_tools: Record<string, (string | {
+                name: string;
+                config: Record<string, unknown>;
+            })[][]>;
+        };
+    }>;
+    readonly setMcpConfig: (mcp: unknown[]) => Promise<{
         awaiting_respawn: {
             keys: string[];
             name: string;
@@ -3138,6 +3304,7 @@ export declare const ApiProvider: import("react").Provider<{
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3170,7 +3337,7 @@ export declare const ApiProvider: import("react").Provider<{
             mode: "unreachable";
         };
     }>;
-    readonly removeToolsEntry: (title: string) => Promise<{
+    readonly addToolsEntries: (entries: readonly unknown[], replace?: boolean) => Promise<{
         awaiting_respawn: {
             keys: string[];
             name: string;
@@ -3195,6 +3362,7 @@ export declare const ApiProvider: import("react").Provider<{
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3227,7 +3395,7 @@ export declare const ApiProvider: import("react").Provider<{
             mode: "unreachable";
         };
     }>;
-    readonly addAgentsEntries: (entries: readonly unknown[], replace?: boolean) => Promise<{
+    readonly removeToolsEntry: (title: string) => Promise<{
         awaiting_respawn: {
             keys: string[];
             name: string;
@@ -3252,6 +3420,7 @@ export declare const ApiProvider: import("react").Provider<{
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3284,7 +3453,7 @@ export declare const ApiProvider: import("react").Provider<{
             mode: "unreachable";
         };
     }>;
-    readonly removeAgentsEntry: (title: string) => Promise<{
+    readonly addAgentsEntries: (entries: readonly unknown[], replace?: boolean) => Promise<{
         awaiting_respawn: {
             keys: string[];
             name: string;
@@ -3309,6 +3478,7 @@ export declare const ApiProvider: import("react").Provider<{
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3341,7 +3511,7 @@ export declare const ApiProvider: import("react").Provider<{
             mode: "unreachable";
         };
     }>;
-    readonly updateApiTools: (body: import("@tai42/api-client").ApiToolsListsBody) => Promise<{
+    readonly removeAgentsEntry: (title: string) => Promise<{
         awaiting_respawn: {
             keys: string[];
             name: string;
@@ -3366,6 +3536,7 @@ export declare const ApiProvider: import("react").Provider<{
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3398,52 +3569,86 @@ export declare const ApiProvider: import("react").Provider<{
             mode: "unreachable";
         };
     }>;
-    readonly listFailedMcps: (signal?: AbortSignal) => Promise<{
-        error: string | null;
-        local_only: boolean;
-        ok: boolean;
-        op: string;
-        reachable: boolean;
-        results: {
-            detail: string | null;
-            error: string | null;
+    readonly updateApiTools: (body: import("@tai42/api-client").ApiToolsListsBody) => Promise<{
+        awaiting_respawn: {
+            keys: string[];
             name: string;
-            outcome: "failed" | "applied" | "missing" | "departed" | "timed_out" | "resyncing" | "recycling" | "stale";
-            payload: unknown;
         }[];
-    }>;
-    readonly reloadFailedMcps: () => Promise<{
-        error: string | null;
-        local_only: boolean;
-        ok: boolean;
-        op: string;
-        reachable: boolean;
-        results: {
-            detail: string | null;
+        env_keys: number;
+        recycle: {
+            fresh: {
+                generation: number;
+                kind: string;
+                name: string;
+            }[];
+            recycle: {
+                detail: string | null;
+                generation_before: number;
+                kind: string;
+                name: string;
+                status: string;
+            }[];
+            recycle_stopped: {
+                detail: string;
+                kind: string;
+                name: string | null;
+            } | null;
+        } | null;
+        span_release_error: string | null;
+        status: string;
+        fanout: {
+            mode: "local-only";
+            note: string;
+        } | {
             error: string | null;
-            name: string;
-            outcome: "failed" | "applied" | "missing" | "departed" | "timed_out" | "resyncing" | "recycling" | "stale";
-            payload: unknown;
-        }[];
-    }>;
-    readonly deregisterMcp: (title: string) => Promise<{
-        error: string | null;
-        local_only: boolean;
-        ok: boolean;
-        op: string;
-        reachable: boolean;
-        results: {
-            detail: string | null;
+            local_only: boolean;
+            op: string;
+            reachable: boolean;
+            results: {
+                detail: string | null;
+                error: string | null;
+                name: string;
+                outcome: "failed" | "applied" | "missing" | "departed" | "timed_out" | "resyncing" | "recycling" | "stale";
+                payload: unknown;
+            }[];
+            mode: "fleet";
+        } | {
             error: string | null;
-            name: string;
-            outcome: "failed" | "applied" | "missing" | "departed" | "timed_out" | "resyncing" | "recycling" | "stale";
-            payload: unknown;
-        }[];
+            local_only: boolean;
+            op: string;
+            reachable: boolean;
+            results: {
+                detail: string | null;
+                error: string | null;
+                name: string;
+                outcome: "failed" | "applied" | "missing" | "departed" | "timed_out" | "resyncing" | "recycling" | "stale";
+                payload: unknown;
+            }[];
+            mode: "unreachable";
+        };
     }>;
     readonly listTemplates: (signal?: AbortSignal) => Promise<string[]>;
     readonly getTemplate: (templateId: string) => Promise<{
-        schema: Record<string, unknown>;
-        template: string;
+        content_type: string | null;
+        id: string;
+        kind: "binary";
+        schema: null;
+        size: number;
+    } | {
+        content: string;
+        content_type: string | null;
+        id: string;
+        kind: "document";
+        schema: null;
+        size: number;
+    } | {
+        content: string;
+        content_type: string | null;
+        id: string;
+        kind: "text";
+        schema: Record<string, unknown> | null;
+        schema_error: string | null;
+        size: number;
     }>;
     readonly uploadTemplate: (path: string, content: string) => Promise<{
         fanout: {
@@ -3524,12 +3729,14 @@ export declare const ApiProvider: import("react").Provider<{
         };
     }>;
     readonly listExtensions: (signal?: AbortSignal) => Promise<{
+        config_schema: Record<string, unknown> | null;
         kind: string;
         multiple: boolean;
         name: string;
     }[]>;
     readonly getToolExtensions: (name: string, signal?: AbortSignal) => Promise<{
         available: {
+            config_schema: Record<string, unknown> | null;
             kind: string;
             multiple: boolean;
             name: string;
@@ -3564,6 +3771,7 @@ export declare const ApiProvider: import("react").Provider<{
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3636,10 +3844,29 @@ export declare const ApiProvider: import("react").Provider<{
         module: string | null;
         present: boolean;
         provider: string | null;
+        surfaces: ("templates" | "storage")[];
     }>;
     readonly listStorageResources: (signal?: AbortSignal) => Promise<{
         resources: string[];
     }>;
+    readonly readStorageResource: (id: string, signal?: AbortSignal) => Promise<{
+        content_type: string | null;
+        id: string;
+        kind: "binary";
+        size: number;
+    } | {
+        content: string;
+        content_type: string | null;
+        id: string;
+        kind: "document";
+        size: number;
+    } | {
+        content: string;
+        content_type: string | null;
+        id: string;
+        kind: "text";
+        size: number;
+    }>;
     readonly statStorageResource: (id: string, signal?: AbortSignal) => Promise<{
         content_type: string | null;
         id: string;
@@ -3763,7 +3990,7 @@ export declare const ApiProvider: import("react").Provider<{
             subjects: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             }[];
         }[] | undefined;
@@ -3788,7 +4015,7 @@ export declare const ApiProvider: import("react").Provider<{
             subjects: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             }[];
         }[] | undefined;
@@ -3816,7 +4043,7 @@ export declare const ApiProvider: import("react").Provider<{
             subjects: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             }[];
         }[] | undefined;
@@ -3826,6 +4053,15 @@ export declare const ApiProvider: import("react").Provider<{
         template: string;
         updated: boolean;
     }>;
+    readonly getStateTemplateReferees: (name: string, template: string, signal?: AbortSignal) => Promise<{
+        action: "rename" | "delete" | "detach";
+        holders: {
+            kind: string;
+            locator: Record<string, string | number>;
+            name: string;
+            summary: string;
+        }[];
+    }>;
     readonly detachStateTemplate: (name: string, template: string) => Promise<{
         detached: boolean;
         state: string;
@@ -3839,7 +4075,7 @@ export declare const ApiProvider: import("react").Provider<{
             subject: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             };
             updated_at: number;
@@ -3850,7 +4086,7 @@ export declare const ApiProvider: import("react").Provider<{
             subjects: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             }[];
         }[] | undefined;
@@ -3862,7 +4098,7 @@ export declare const ApiProvider: import("react").Provider<{
             subject: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             };
             updated_at: number;
@@ -3874,7 +4110,7 @@ export declare const ApiProvider: import("react").Provider<{
             subjects: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             }[];
         }[] | undefined;
@@ -3896,7 +4132,7 @@ export declare const ApiProvider: import("react").Provider<{
             subjects: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             }[];
         }[];
@@ -3908,7 +4144,7 @@ export declare const ApiProvider: import("react").Provider<{
             subject: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             };
             updated_at: number;
@@ -3919,14 +4155,14 @@ export declare const ApiProvider: import("react").Provider<{
         canonical_subject: {
             key: string;
             kind: string;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
         };
         data: Record<string, unknown>;
         folded_from: {
             key: string;
             kind: string;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
         }[];
         seq: number;
@@ -3934,7 +4170,7 @@ export declare const ApiProvider: import("react").Provider<{
         subject: {
             key: string;
             kind: string;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
         };
     } | null>;
@@ -3942,14 +4178,14 @@ export declare const ApiProvider: import("react").Provider<{
         canonical_subject: {
             key: string;
             kind: string;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
         };
         data: Record<string, unknown>;
         folded_from: {
             key: string;
             kind: string;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
         }[];
         seq: number;
@@ -3957,7 +4193,7 @@ export declare const ApiProvider: import("react").Provider<{
         subject: {
             key: string;
             kind: string;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
         };
     }>;
@@ -3965,14 +4201,14 @@ export declare const ApiProvider: import("react").Provider<{
         canonical_subject: {
             key: string;
             kind: string;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
         };
         data: Record<string, unknown>;
         folded_from: {
             key: string;
             kind: string;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
         }[];
         seq: number;
@@ -3980,7 +4216,7 @@ export declare const ApiProvider: import("react").Provider<{
         subject: {
             key: string;
             kind: string;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
         };
     }>;
@@ -4028,7 +4264,7 @@ export declare const ApiProvider: import("react").Provider<{
             origin: {
                 actor: string | null;
                 consumer: string | null;
-                door: "tool" | "api" | "conversation" | "hook" | "schedule" | "operator";
+                door: "api" | "tool" | "conversation" | "hook" | "schedule" | "operator";
                 inbound_id: string | null;
                 meta: Record<string, unknown> | null;
                 op_id: string | null;
@@ -4239,7 +4475,7 @@ export declare const ApiProvider: import("react").Provider<{
             subjects: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             }[];
         }[] | undefined;
@@ -4267,7 +4503,7 @@ export declare const ApiProvider: import("react").Provider<{
                 subject: {
                     key: string;
                     kind: string;
-                    target_kind: "tool" | "agent";
+                    target_kind: "agent" | "tool";
                     target_name: string;
                 };
             }[];
@@ -4289,9 +4525,27 @@ export declare const ApiProvider: import("react").Provider<{
         conflicted: boolean;
         conflicted_reason: string | null;
         description: string;
-        input_schema: Record<string, unknown> | null;
+        input_map: string | {
+            content?: string | undefined;
+            id?: string | undefined;
+            kwargs?: Record<string, unknown> | undefined;
+        } | null;
+        input_schema: Record<string, unknown> | {
+            content?: string | undefined;
+            id?: string | undefined;
+            kwargs?: Record<string, unknown> | undefined;
+        } | null;
         name: string;
-        output_schema: Record<string, unknown> | null;
+        output_map: string | {
+            content?: string | undefined;
+            id?: string | undefined;
+            kwargs?: Record<string, unknown> | undefined;
+        } | null;
+        output_schema: Record<string, unknown> | {
+            content?: string | undefined;
+            id?: string | undefined;
+            kwargs?: Record<string, unknown> | undefined;
+        } | null;
         used_by: string[];
         uses: string[];
         extensions: (string | {
@@ -4305,9 +4559,27 @@ export declare const ApiProvider: import("react").Provider<{
         conflicted: boolean;
         conflicted_reason: string | null;
         description: string;
-        input_schema: Record<string, unknown> | null;
+        input_map: string | {
+            content?: string | undefined;
+            id?: string | undefined;
+            kwargs?: Record<string, unknown> | undefined;
+        } | null;
+        input_schema: Record<string, unknown> | {
+            content?: string | undefined;
+            id?: string | undefined;
+            kwargs?: Record<string, unknown> | undefined;
+        } | null;
         name: string;
-        output_schema: Record<string, unknown> | null;
+        output_map: string | {
+            content?: string | undefined;
+            id?: string | undefined;
+            kwargs?: Record<string, unknown> | undefined;
+        } | null;
+        output_schema: Record<string, unknown> | {
+            content?: string | undefined;
+            id?: string | undefined;
+            kwargs?: Record<string, unknown> | undefined;
+        } | null;
         used_by: string[];
         uses: string[];
         extensions: (string | {
@@ -4322,9 +4594,27 @@ export declare const ApiProvider: import("react").Provider<{
         conflicted_reason: string | null;
         description: string;
         fixed_kwargs: Record<string, unknown>;
-        input_schema: Record<string, unknown> | null;
+        input_map: string | {
+            content?: string | undefined;
+            id?: string | undefined;
+            kwargs?: Record<string, unknown> | undefined;
+        } | null;
+        input_schema: Record<string, unknown> | {
+            content?: string | undefined;
+            id?: string | undefined;
+            kwargs?: Record<string, unknown> | undefined;
+        } | null;
         name: string;
-        output_schema: Record<string, unknown> | null;
+        output_map: string | {
+            content?: string | undefined;
+            id?: string | undefined;
+            kwargs?: Record<string, unknown> | undefined;
+        } | null;
+        output_schema: Record<string, unknown> | {
+            content?: string | undefined;
+            id?: string | undefined;
+            kwargs?: Record<string, unknown> | undefined;
+        } | null;
         used_by: string[];
         uses: string[];
         extensions: (string | {
@@ -4342,11 +4632,21 @@ export declare const ApiProvider: import("react").Provider<{
             description: string;
             extensions: (string | Record<string, unknown>)[][];
             fixed_kwargs: Record<string, unknown>;
+            input_map: string | {
+                content?: string | undefined;
+                id?: string | undefined;
+                kwargs?: Record<string, unknown> | undefined;
+            } | null;
             input_schema: Record<string, unknown> | {
                 content?: string | undefined;
                 id?: string | undefined;
                 kwargs?: Record<string, unknown> | undefined;
             } | null;
+            output_map: string | {
+                content?: string | undefined;
+                id?: string | undefined;
+                kwargs?: Record<string, unknown> | undefined;
+            } | null;
             output_schema: Record<string, unknown> | {
                 content?: string | undefined;
                 id?: string | undefined;
@@ -4407,11 +4707,21 @@ export declare const ApiProvider: import("react").Provider<{
             description: string;
             extensions: (string | Record<string, unknown>)[][];
             fixed_kwargs: Record<string, unknown>;
+            input_map: string | {
+                content?: string | undefined;
+                id?: string | undefined;
+                kwargs?: Record<string, unknown> | undefined;
+            } | null;
             input_schema: Record<string, unknown> | {
                 content?: string | undefined;
                 id?: string | undefined;
                 kwargs?: Record<string, unknown> | undefined;
             } | null;
+            output_map: string | {
+                content?: string | undefined;
+                id?: string | undefined;
+                kwargs?: Record<string, unknown> | undefined;
+            } | null;
             output_schema: Record<string, unknown> | {
                 content?: string | undefined;
                 id?: string | undefined;
@@ -4472,11 +4782,21 @@ export declare const ApiProvider: import("react").Provider<{
             description: string;
             extensions: (string | Record<string, unknown>)[][];
             fixed_kwargs: Record<string, unknown>;
+            input_map: string | {
+                content?: string | undefined;
+                id?: string | undefined;
+                kwargs?: Record<string, unknown> | undefined;
+            } | null;
             input_schema: Record<string, unknown> | {
                 content?: string | undefined;
                 id?: string | undefined;
                 kwargs?: Record<string, unknown> | undefined;
             } | null;
+            output_map: string | {
+                content?: string | undefined;
+                id?: string | undefined;
+                kwargs?: Record<string, unknown> | undefined;
+            } | null;
             output_schema: Record<string, unknown> | {
                 content?: string | undefined;
                 id?: string | undefined;
@@ -4585,9 +4905,14 @@ export declare const ApiProvider: import("react").Provider<{
         name: string;
         renamed_from: string;
     }>;
-    readonly getPresetReferees: (name: string, signal?: AbortSignal) => Promise<{
-        name: string;
-        referees: string[];
+    readonly getPresetReferees: (name: string, action: import("@tai42/api-client").PresetHolderAction, signal?: AbortSignal) => Promise<{
+        action: "rename" | "delete" | "detach";
+        holders: {
+            kind: string;
+            locator: Record<string, string | number>;
+            name: string;
+            summary: string;
+        }[];
     }>;
     readonly validatePreset: (body: import("@tai42/api-client").ValidatePresetBody) => Promise<{
         error: string | null;
@@ -4795,7 +5120,9 @@ export declare const ApiProvider: import("react").Provider<{
         readonly MEDIA_ROUTE_PREFIX: "/api/interactions/media/";
         readonly PERSON_KIND: "person";
     };
-    readonly request: <S extends Parameters<typeof import("@tai42/api-client").apiRequest>[2]>(path: string, schema: S, options?: Parameters<typeof import("@tai42/api-client").apiRequest>[3]) => Promise<import("zod").infer<S>>;
+    readonly request: <S extends Parameters<typeof import("@tai42/api-client").apiRequest>[2]>(path: string, schema: S, options?: Parameters<typeof import("@tai42/api-client").apiRequest>[3]) => Promise<import("zod").output<S>>;
+    readonly holdersFromError: typeof import("../../../api-client/dist/errors").holdersFromError;
+    readonly storedPresetFaultFromError: typeof import("../../../api-client/dist/errors").storedPresetFaultFromError;
 } | null>;
 export declare function useApi(): ApiClient;
 export type { ApiClient };