@tai42/api-client 25.0.0 → 26.0.0

package/dist/client/index.d.ts

@@ -1,11 +1,12 @@
 /** Composition root: assembles the per-resource sub-clients into the client. */
+import { holdersFromError, storedPresetFaultFromError } from '../errors';
 import type { ApiConfig } from '../http';
 export type { AddUrlToScopeBody, ApiKeyBody, ClaimLinkBody, PinRoutePublicBody, RoleCreateBody, RoleUpdateBody, } from './auth-client';
 export type { AddServerArgs, DiscoverServerTarget, SetProviderClientArgs, StartConnectArgs, } from './connectors-client';
 export type { ConversationMessageSearchQuery, ConversationThreadFilters, ConversationThreadMessageBody, ConversationTranscriptQuery, } from './conversations-client';
 export type { TopicVerifierBody } from './hooks-client';
 export { isSafeApiPath } from './login-client';
-export type { ApiToolsListsBody } from './manifest-client';
+export type { ApiToolsListsBody, McpToolFilter } from './manifest-client';
 export type { MarketplaceInstallBody, MarketplaceInstallPreviewBody, MarketplaceSearchQuery, MarketplaceUninstallBody, } from './marketplace-client';
 export type { MetricsQuery, RunsQuery } from './observability-client';
 export type { ValidateConditionBody } from './policy-client';
@@ -88,7 +89,7 @@ export declare function createApiClient(config: ApiConfig): {
                     base: string;
                     paths: {
                         path: string;
-                        methods: ("GET" | "DELETE" | "PATCH" | "POST" | "PUT")[];
+                        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
                         public: boolean;
                     }[];
                 } | null | undefined;
@@ -136,7 +137,7 @@ export declare function createApiClient(config: ApiConfig): {
             conflict_path: string;
             full_path: string;
             item: string;
-            methods: ("GET" | "DELETE" | "PATCH" | "POST" | "PUT")[];
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
         }[];
         delivery: "package" | "descriptor";
         items: {
@@ -146,7 +147,7 @@ export declare function createApiClient(config: ApiConfig): {
             kind: string;
             routes: {
                 full_path: string;
-                methods: ("GET" | "DELETE" | "PATCH" | "POST" | "PUT")[];
+                methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
                 path: string;
                 public: boolean;
             }[];
@@ -155,12 +156,12 @@ export declare function createApiClient(config: ApiConfig): {
         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: {
@@ -175,27 +176,28 @@ export declare function createApiClient(config: ApiConfig): {
         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;
@@ -215,49 +217,50 @@ export declare function createApiClient(config: ApiConfig): {
                     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("./marketplace-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;
@@ -277,36 +280,67 @@ export declare function createApiClient(config: ApiConfig): {
                     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("./marketplace-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;
@@ -326,30 +360,46 @@ export declare function createApiClient(config: ApiConfig): {
                     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<{
@@ -399,7 +449,7 @@ export declare function createApiClient(config: ApiConfig): {
             inputPreview: unknown;
             latencyMs: number | null;
             outputPreview: unknown;
-            status: "error" | "success";
+            status: "success" | "error";
             tags: string[];
             totalTokens: number | null;
             traceId: string;
@@ -465,7 +515,7 @@ export declare function createApiClient(config: ApiConfig): {
     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;
@@ -545,6 +595,7 @@ export declare function createApiClient(config: ApiConfig): {
                 } | null;
             } | null;
             skipped: number;
+            span_release_error: string | null;
             updated: number;
             fanout: {
                 mode: "local-only";
@@ -671,6 +722,7 @@ export declare function createApiClient(config: ApiConfig): {
         owner_user_id: string;
     }>;
     readonly getMe: (signal?: AbortSignal) => Promise<{
+        access_control_enabled: boolean;
         admin: boolean;
         agents: string[];
         mintable: boolean;
@@ -915,6 +967,7 @@ export declare function createApiClient(config: ApiConfig): {
         mapped: string | null;
         methods: string[];
         path: string;
+        role_reach: "public" | "level" | "self_service" | "admin_only" | null;
         summary: string;
         tags: string[];
     }[]>;
@@ -1052,7 +1105,7 @@ export declare function createApiClient(config: ApiConfig): {
                     kwargs?: Record<string, unknown> | undefined;
                 };
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             } | null;
             tool: string;
@@ -1213,7 +1266,7 @@ export declare function createApiClient(config: ApiConfig): {
                 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;
         } | {
@@ -1270,7 +1323,7 @@ export declare function createApiClient(config: ApiConfig): {
                 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;
         })[];
@@ -1334,7 +1387,7 @@ export declare function createApiClient(config: ApiConfig): {
                 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;
         } | {
@@ -1391,7 +1444,7 @@ export declare function createApiClient(config: ApiConfig): {
                 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;
         };
@@ -1945,7 +1998,7 @@ export declare function createApiClient(config: ApiConfig): {
                     }[];
                 }[];
             } | null;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
         }[];
         total: number;
@@ -1997,7 +2050,7 @@ export declare function createApiClient(config: ApiConfig): {
                 }[];
             }[];
         } | null;
-        target_kind: "tool" | "agent";
+        target_kind: "agent" | "tool";
         target_name: string;
     }>;
     readonly setConversationConfig: (config: import("..").TargetConversationConfig) => Promise<{
@@ -2047,16 +2100,16 @@ export declare function createApiClient(config: ApiConfig): {
                     }[];
                 }[];
             } | 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("..").ConversationTargetKind, targetName: string) => Promise<{
         removed: boolean;
-        target_kind: "tool" | "agent";
+        target_kind: "agent" | "tool";
         target_name: string;
     }>;
     readonly listFailedConversationMessages: (signal?: AbortSignal) => Promise<{
@@ -2303,7 +2356,10 @@ export declare function createApiClient(config: ApiConfig): {
         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;
@@ -2312,7 +2368,7 @@ export declare function createApiClient(config: ApiConfig): {
         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;
@@ -2405,6 +2461,7 @@ export declare function createApiClient(config: ApiConfig): {
                 scopes: string[];
             }[];
         };
+        span_release_error: string | null;
         fanout: {
             mode: "local-only";
             note: string;
@@ -2439,6 +2496,7 @@ export declare function createApiClient(config: ApiConfig): {
     readonly removeProvider: (id: string) => Promise<{
         provider_id: string;
         removed_clients: number;
+        span_release_error: string | null;
         fanout: {
             mode: "local-only";
             note: string;
@@ -2495,6 +2553,7 @@ export declare function createApiClient(config: ApiConfig): {
                 scopes: string[];
             }[];
         };
+        span_release_error: string | null;
         fanout: {
             mode: "local-only";
             note: string;
@@ -2593,6 +2652,7 @@ export declare function createApiClient(config: ApiConfig): {
     } | {
         added_manifest_entries: string[];
         connection_id: string;
+        span_release_error: string | null;
         fanout: {
             mode: "local-only";
             note: string;
@@ -2627,6 +2687,7 @@ export declare function createApiClient(config: ApiConfig): {
     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: {
@@ -2672,6 +2733,7 @@ export declare function createApiClient(config: ApiConfig): {
         enabled_sub_services: string[];
         flow_id: string | null;
         removed_manifest_entries: string[];
+        span_release_error: string | null;
         fanout: {
             mode: "local-only";
             note: string;
@@ -2715,6 +2777,7 @@ export declare function createApiClient(config: ApiConfig): {
         connection_id: string;
         kind: "success";
         return_url: string;
+        span_release_error: string | null;
         fanout: {
             mode: "local-only";
             note: string;
@@ -2771,6 +2834,7 @@ export declare function createApiClient(config: ApiConfig): {
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -2813,6 +2877,28 @@ export declare function createApiClient(config: ApiConfig): {
                 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;
@@ -2871,6 +2957,7 @@ export declare function createApiClient(config: ApiConfig): {
             name: string | null;
         } | null;
         refused: string[];
+        span_release_error: string | null;
         fanout: {
             mode: "local-only";
             note: string;
@@ -2955,6 +3042,7 @@ export declare function createApiClient(config: ApiConfig): {
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3020,18 +3108,37 @@ export declare function createApiClient(config: ApiConfig): {
         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("./manifest-client").McpToolFilter) => Promise<{
         awaiting_respawn: {
             keys: string[];
             name: string;
@@ -3056,6 +3163,7 @@ export declare function createApiClient(config: ApiConfig): {
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3088,23 +3196,21 @@ export declare function createApiClient(config: ApiConfig): {
             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;
@@ -3118,7 +3224,68 @@ export declare function createApiClient(config: ApiConfig): {
             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;
@@ -3143,6 +3310,7 @@ export declare function createApiClient(config: ApiConfig): {
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3175,7 +3343,7 @@ export declare function createApiClient(config: ApiConfig): {
             mode: "unreachable";
         };
     }>;
-    readonly removeToolsEntry: (title: string) => Promise<{
+    readonly addToolsEntries: (entries: readonly unknown[], replace?: boolean) => Promise<{
         awaiting_respawn: {
             keys: string[];
             name: string;
@@ -3200,6 +3368,7 @@ export declare function createApiClient(config: ApiConfig): {
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3232,7 +3401,7 @@ export declare function createApiClient(config: ApiConfig): {
             mode: "unreachable";
         };
     }>;
-    readonly addAgentsEntries: (entries: readonly unknown[], replace?: boolean) => Promise<{
+    readonly removeToolsEntry: (title: string) => Promise<{
         awaiting_respawn: {
             keys: string[];
             name: string;
@@ -3257,6 +3426,7 @@ export declare function createApiClient(config: ApiConfig): {
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3289,7 +3459,7 @@ export declare function createApiClient(config: ApiConfig): {
             mode: "unreachable";
         };
     }>;
-    readonly removeAgentsEntry: (title: string) => Promise<{
+    readonly addAgentsEntries: (entries: readonly unknown[], replace?: boolean) => Promise<{
         awaiting_respawn: {
             keys: string[];
             name: string;
@@ -3314,6 +3484,7 @@ export declare function createApiClient(config: ApiConfig): {
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3346,7 +3517,7 @@ export declare function createApiClient(config: ApiConfig): {
             mode: "unreachable";
         };
     }>;
-    readonly updateApiTools: (body: import("./manifest-client").ApiToolsListsBody) => Promise<{
+    readonly removeAgentsEntry: (title: string) => Promise<{
         awaiting_respawn: {
             keys: string[];
             name: string;
@@ -3371,6 +3542,7 @@ export declare function createApiClient(config: ApiConfig): {
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3403,52 +3575,86 @@ export declare function createApiClient(config: ApiConfig): {
             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("./manifest-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: {
@@ -3529,12 +3735,14 @@ export declare function createApiClient(config: ApiConfig): {
         };
     }>;
     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;
@@ -3569,6 +3777,7 @@ export declare function createApiClient(config: ApiConfig): {
                 name: string | null;
             } | null;
         } | null;
+        span_release_error: string | null;
         status: string;
         fanout: {
             mode: "local-only";
@@ -3641,10 +3850,29 @@ export declare function createApiClient(config: ApiConfig): {
         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;
@@ -3768,7 +3996,7 @@ export declare function createApiClient(config: ApiConfig): {
             subjects: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             }[];
         }[] | undefined;
@@ -3793,7 +4021,7 @@ export declare function createApiClient(config: ApiConfig): {
             subjects: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             }[];
         }[] | undefined;
@@ -3821,7 +4049,7 @@ export declare function createApiClient(config: ApiConfig): {
             subjects: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             }[];
         }[] | undefined;
@@ -3831,6 +4059,15 @@ export declare function createApiClient(config: ApiConfig): {
         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;
@@ -3844,7 +4081,7 @@ export declare function createApiClient(config: ApiConfig): {
             subject: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             };
             updated_at: number;
@@ -3855,7 +4092,7 @@ export declare function createApiClient(config: ApiConfig): {
             subjects: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             }[];
         }[] | undefined;
@@ -3867,7 +4104,7 @@ export declare function createApiClient(config: ApiConfig): {
             subject: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             };
             updated_at: number;
@@ -3879,7 +4116,7 @@ export declare function createApiClient(config: ApiConfig): {
             subjects: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             }[];
         }[] | undefined;
@@ -3901,7 +4138,7 @@ export declare function createApiClient(config: ApiConfig): {
             subjects: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             }[];
         }[];
@@ -3913,7 +4150,7 @@ export declare function createApiClient(config: ApiConfig): {
             subject: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             };
             updated_at: number;
@@ -3924,14 +4161,14 @@ export declare function createApiClient(config: ApiConfig): {
         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;
@@ -3939,7 +4176,7 @@ export declare function createApiClient(config: ApiConfig): {
         subject: {
             key: string;
             kind: string;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
         };
     } | null>;
@@ -3947,14 +4184,14 @@ export declare function createApiClient(config: ApiConfig): {
         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;
@@ -3962,7 +4199,7 @@ export declare function createApiClient(config: ApiConfig): {
         subject: {
             key: string;
             kind: string;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
         };
     }>;
@@ -3970,14 +4207,14 @@ export declare function createApiClient(config: ApiConfig): {
         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;
@@ -3985,7 +4222,7 @@ export declare function createApiClient(config: ApiConfig): {
         subject: {
             key: string;
             kind: string;
-            target_kind: "tool" | "agent";
+            target_kind: "agent" | "tool";
             target_name: string;
         };
     }>;
@@ -4033,7 +4270,7 @@ export declare function createApiClient(config: ApiConfig): {
             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;
@@ -4244,7 +4481,7 @@ export declare function createApiClient(config: ApiConfig): {
             subjects: {
                 key: string;
                 kind: string;
-                target_kind: "tool" | "agent";
+                target_kind: "agent" | "tool";
                 target_name: string;
             }[];
         }[] | undefined;
@@ -4272,7 +4509,7 @@ export declare function createApiClient(config: ApiConfig): {
                 subject: {
                     key: string;
                     kind: string;
-                    target_kind: "tool" | "agent";
+                    target_kind: "agent" | "tool";
                     target_name: string;
                 };
             }[];
@@ -4294,9 +4531,27 @@ export declare function createApiClient(config: ApiConfig): {
         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 | {
@@ -4310,9 +4565,27 @@ export declare function createApiClient(config: ApiConfig): {
         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 | {
@@ -4327,9 +4600,27 @@ export declare function createApiClient(config: ApiConfig): {
         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 | {
@@ -4347,11 +4638,21 @@ export declare function createApiClient(config: ApiConfig): {
             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;
@@ -4412,11 +4713,21 @@ export declare function createApiClient(config: ApiConfig): {
             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;
@@ -4477,11 +4788,21 @@ export declare function createApiClient(config: ApiConfig): {
             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;
@@ -4590,9 +4911,14 @@ export declare function createApiClient(config: ApiConfig): {
         name: string;
         renamed_from: string;
     }>;
-    readonly getPresetReferees: (name: string, signal?: AbortSignal) => Promise<{
-        name: string;
-        referees: string[];
+    readonly getPresetReferees: (name: string, action: import("..").PresetHolderAction, signal?: AbortSignal) => Promise<{
+        action: "rename" | "delete" | "detach";
+        holders: {
+            kind: string;
+            locator: Record<string, string | number>;
+            name: string;
+            summary: string;
+        }[];
     }>;
     readonly validatePreset: (body: import("./presets-client").ValidatePresetBody) => Promise<{
         error: string | null;
@@ -4807,7 +5133,12 @@ export declare function createApiClient(config: ApiConfig): {
     /** The host's authenticated request for a plugin's own routes: the same auth header,
      *  401 handling, error classes and `{ data }` unwrap as every core call. Core routes
      *  use the named methods. */
-    readonly request: <S extends Parameters<typeof import("..").apiRequest>[2]>(path: string, schema: S, options?: Parameters<typeof import("..").apiRequest>[3]) => Promise<import("zod").infer<S>>;
+    readonly request: <S extends Parameters<typeof import("..").apiRequest>[2]>(path: string, schema: S, options?: Parameters<typeof import("..").apiRequest>[3]) => Promise<import("zod").output<S>>;
+    /** Readers of this client's refusals. They recognise the `ApiError` this client throws, so a
+     *  caller that holds no copy of the error classes (a plugin bundle) reads a refusal through
+     *  the client that raised it. */
+    readonly holdersFromError: typeof holdersFromError;
+    readonly storedPresetFaultFromError: typeof storedPresetFaultFromError;
 };
 export type ApiClient = ReturnType<typeof createApiClient>;
 //# sourceMappingURL=index.d.ts.map