@tai42/api-client 2.0.0 → 4.0.0

package/dist/schemas.d.ts

@@ -79,31 +79,41 @@ export type ToolMediaResult = z.infer<typeof toolMediaResult>;
  * FastMCP `meta` under `tai42/hidden`; a tool that never declared it is not hidden).
  * The tool_meta overlay's tri-state override is merged on top client-side; this read
  * exposes only the declaration.
+ *
+ * `badges` are the tool's plugin-DECLARED capability labels — purely INFORMATIONAL
+ * (e.g. `network`, `filesystem`), never a gate the server enforces. The overlay's
+ * own badges are merged on top client-side; this read exposes only the declaration.
  */
 export declare const toolTagEntry: z.ZodObject<{
     name: z.ZodString;
     tags: z.ZodArray<z.ZodString, "many">;
+    badges: z.ZodArray<z.ZodString, "many">;
     hidden: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
     name: string;
     tags: string[];
+    badges: string[];
     hidden: boolean;
 }, {
     name: string;
     tags: string[];
+    badges: string[];
     hidden: boolean;
 }>;
 export declare const toolTags: z.ZodArray<z.ZodObject<{
     name: z.ZodString;
     tags: z.ZodArray<z.ZodString, "many">;
+    badges: z.ZodArray<z.ZodString, "many">;
     hidden: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
     name: string;
     tags: string[];
+    badges: string[];
     hidden: boolean;
 }, {
     name: string;
     tags: string[];
+    badges: string[];
     hidden: boolean;
 }>, "many">;
 export type ToolTagEntry = z.infer<typeof toolTagEntry>;
@@ -667,7 +677,9 @@ export type FolderRecord = z.infer<typeof folderRecord>;
  * The organizational overlay for one tool, keyed by `tool_name`. `display_name`
  * overrides the rendered label (`display_name ?? name`); `folder_id` places the tool
  * in a folder (`null` = unfiled); `tags` is the user's editable categorization,
- * merged with the tool's read-only native tags by the UI; `hidden` is TRI-STATE —
+ * merged with the tool's read-only native tags by the UI; `badges` is the operator's
+ * editable capability-label overlay, merged with the tool's read-only plugin-declared
+ * badges by the UI (INFORMATIONAL, never an enforced gate); `hidden` is TRI-STATE —
  * `null` = defer to the plugin declaration, `true` = force hidden, `false` = force
  * visible. A drift throws `ApiSchemaError`.
  */
@@ -676,16 +688,19 @@ export declare const toolMetaRecord: z.ZodObject<{
     display_name: z.ZodNullable<z.ZodString>;
     folder_id: z.ZodNullable<z.ZodString>;
     tags: z.ZodArray<z.ZodString, "many">;
+    badges: z.ZodArray<z.ZodString, "many">;
     hidden: z.ZodNullable<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     tool_name: string;
     tags: string[];
+    badges: string[];
     hidden: boolean | null;
     display_name: string | null;
     folder_id: string | null;
 }, {
     tool_name: string;
     tags: string[];
+    badges: string[];
     hidden: boolean | null;
     display_name: string | null;
     folder_id: string | null;
@@ -715,16 +730,19 @@ export declare const toolMetaOverlay: z.ZodObject<{
         display_name: z.ZodNullable<z.ZodString>;
         folder_id: z.ZodNullable<z.ZodString>;
         tags: z.ZodArray<z.ZodString, "many">;
+        badges: z.ZodArray<z.ZodString, "many">;
         hidden: z.ZodNullable<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         tool_name: string;
         tags: string[];
+        badges: string[];
         hidden: boolean | null;
         display_name: string | null;
         folder_id: string | null;
     }, {
         tool_name: string;
         tags: string[];
+        badges: string[];
         hidden: boolean | null;
         display_name: string | null;
         folder_id: string | null;
@@ -738,6 +756,7 @@ export declare const toolMetaOverlay: z.ZodObject<{
     meta: {
         tool_name: string;
         tags: string[];
+        badges: string[];
         hidden: boolean | null;
         display_name: string | null;
         folder_id: string | null;
@@ -751,6 +770,7 @@ export declare const toolMetaOverlay: z.ZodObject<{
     meta: {
         tool_name: string;
         tags: string[];
+        badges: string[];
         hidden: boolean | null;
         display_name: string | null;
         folder_id: string | null;
@@ -4186,6 +4206,7 @@ export declare const conversationThreadsPage: z.ZodObject<{
     page: z.ZodNumber;
     page_size: z.ZodNumber;
     next_page: z.ZodNullable<z.ZodNumber>;
+    truncated: z.ZodBoolean;
     items: z.ZodArray<z.ZodObject<{
         thread_id: z.ZodString;
         client_address: z.ZodString;
@@ -4217,6 +4238,7 @@ export declare const conversationThreadsPage: z.ZodObject<{
     page: number;
     page_size: number;
     next_page: number | null;
+    truncated: boolean;
 }, {
     items: {
         thread_id: string;
@@ -4229,6 +4251,7 @@ export declare const conversationThreadsPage: z.ZodObject<{
     page: number;
     page_size: number;
     next_page: number | null;
+    truncated: boolean;
 }>;
 export type ConversationThreadsPage = z.infer<typeof conversationThreadsPage>;
 /**
@@ -4317,6 +4340,7 @@ export declare const conversationTranscriptPage: z.ZodObject<{
     page: z.ZodNumber;
     page_size: z.ZodNumber;
     next_page: z.ZodNullable<z.ZodNumber>;
+    truncated: z.ZodBoolean;
     items: z.ZodArray<z.ZodObject<{
         message_id: z.ZodString;
         route_name: z.ZodString;
@@ -4408,6 +4432,7 @@ export declare const conversationTranscriptPage: z.ZodObject<{
     page: number;
     page_size: number;
     next_page: number | null;
+    truncated: boolean;
     order: "asc" | "desc";
 }, {
     items: {
@@ -4436,9 +4461,145 @@ export declare const conversationTranscriptPage: z.ZodObject<{
     page: number;
     page_size: number;
     next_page: number | null;
+    truncated: boolean;
     order: "asc" | "desc";
 }>;
 export type ConversationTranscriptPage = z.infer<typeof conversationTranscriptPage>;
+/**
+ * A route-scoped message search (`GET /api/conversations/{route}/messages/search?q`):
+ * every record on the route whose text matches `q`, across threads, newest first.
+ * The record shape is the transcript's exactly, so a hit renders with the same
+ * projection. `truncated` says the match set outran the door's scan cap — surfaced
+ * loudly, never a silent cut.
+ */
+export declare const conversationMessageSearchPage: z.ZodObject<{
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    page_size: z.ZodNumber;
+    next_page: z.ZodNullable<z.ZodNumber>;
+    truncated: z.ZodBoolean;
+    items: z.ZodArray<z.ZodObject<{
+        message_id: z.ZodString;
+        route_name: z.ZodString;
+        door: z.ZodEnum<["api", "channel"]>;
+        thread_id: z.ZodString;
+        client_address: z.ZodString;
+        caller_principal: z.ZodNullable<z.ZodString>;
+        inbound_text: z.ZodString;
+        answer_status: z.ZodNullable<z.ZodEnum<["answered", "error", "silent"]>>;
+        answer: z.ZodNullable<z.ZodString>;
+        origin: z.ZodEnum<["client", "operator"]>;
+        delivery_status: z.ZodEnum<["accepted", "pending_delivery", "provisional", "delivered", "failed", "shed", "silent"]>;
+        created_at: z.ZodNumber;
+        updated_at: z.ZodNumber;
+        channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        our_identity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        provider_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        callback_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        outbound_message_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        attempts: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        created_at: number;
+        origin: "client" | "operator";
+        route_name: string;
+        door: "channel" | "api";
+        thread_id: string;
+        client_address: string;
+        message_id: string;
+        caller_principal: string | null;
+        inbound_text: string;
+        answer_status: "error" | "silent" | "answered" | null;
+        answer: string | null;
+        delivery_status: "failed" | "accepted" | "pending_delivery" | "provisional" | "delivered" | "shed" | "silent";
+        updated_at: number;
+        error?: string | null | undefined;
+        channel?: string | null | undefined;
+        our_identity?: string | null | undefined;
+        callback_url?: string | null | undefined;
+        provider_message_id?: string | null | undefined;
+        outbound_message_ids?: string[] | undefined;
+        attempts?: number | undefined;
+    }, {
+        created_at: number;
+        origin: "client" | "operator";
+        route_name: string;
+        door: "channel" | "api";
+        thread_id: string;
+        client_address: string;
+        message_id: string;
+        caller_principal: string | null;
+        inbound_text: string;
+        answer_status: "error" | "silent" | "answered" | null;
+        answer: string | null;
+        delivery_status: "failed" | "accepted" | "pending_delivery" | "provisional" | "delivered" | "shed" | "silent";
+        updated_at: number;
+        error?: string | null | undefined;
+        channel?: string | null | undefined;
+        our_identity?: string | null | undefined;
+        callback_url?: string | null | undefined;
+        provider_message_id?: string | null | undefined;
+        outbound_message_ids?: string[] | undefined;
+        attempts?: number | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        created_at: number;
+        origin: "client" | "operator";
+        route_name: string;
+        door: "channel" | "api";
+        thread_id: string;
+        client_address: string;
+        message_id: string;
+        caller_principal: string | null;
+        inbound_text: string;
+        answer_status: "error" | "silent" | "answered" | null;
+        answer: string | null;
+        delivery_status: "failed" | "accepted" | "pending_delivery" | "provisional" | "delivered" | "shed" | "silent";
+        updated_at: number;
+        error?: string | null | undefined;
+        channel?: string | null | undefined;
+        our_identity?: string | null | undefined;
+        callback_url?: string | null | undefined;
+        provider_message_id?: string | null | undefined;
+        outbound_message_ids?: string[] | undefined;
+        attempts?: number | undefined;
+    }[];
+    total: number;
+    page: number;
+    page_size: number;
+    next_page: number | null;
+    truncated: boolean;
+}, {
+    items: {
+        created_at: number;
+        origin: "client" | "operator";
+        route_name: string;
+        door: "channel" | "api";
+        thread_id: string;
+        client_address: string;
+        message_id: string;
+        caller_principal: string | null;
+        inbound_text: string;
+        answer_status: "error" | "silent" | "answered" | null;
+        answer: string | null;
+        delivery_status: "failed" | "accepted" | "pending_delivery" | "provisional" | "delivered" | "shed" | "silent";
+        updated_at: number;
+        error?: string | null | undefined;
+        channel?: string | null | undefined;
+        our_identity?: string | null | undefined;
+        callback_url?: string | null | undefined;
+        provider_message_id?: string | null | undefined;
+        outbound_message_ids?: string[] | undefined;
+        attempts?: number | undefined;
+    }[];
+    total: number;
+    page: number;
+    page_size: number;
+    next_page: number | null;
+    truncated: boolean;
+}>;
+export type ConversationMessageSearchPage = z.infer<typeof conversationMessageSearchPage>;
 /**
  * Who answers a thread's incoming messages: `agent` lets the flow reply on its
  * own; `manual` holds the flow back so a human answers. `source` says whether the
@@ -6990,10 +7151,74 @@ export declare const runTrace: z.ZodObject<{
     metadata?: unknown;
 }>;
 export type RunTrace = z.infer<typeof runTrace>;
+/**
+ * The CLOSED HTTP-method enum fixed by the contract's RouteMethod, the one source
+ * for every route-method field (declaration and install/preview responses alike):
+ * a wire method the contract does not define fails loudly as drift rather than
+ * passing through silently.
+ */
+export declare const routeMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>;
+export type RouteMethod = z.infer<typeof routeMethod>;
+/**
+ * One HTTP route an item declares in its `tai-plugin.yml`: a `path` relative to
+ * the item's mount base, the `methods` it answers, and whether it is served
+ * `public` (without authentication). The absolute path an operator sees is
+ * resolved from the base at install time.
+ */
+export declare const marketplaceRouteDecl: z.ZodObject<{
+    path: z.ZodString;
+    methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+    public: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    public: boolean;
+    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+}, {
+    path: string;
+    public: boolean;
+    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+}>;
+export type MarketplaceRouteDecl = z.infer<typeof marketplaceRouteDecl>;
+/**
+ * A route-carrying item's declared mount: the default `base` prefix the routes
+ * hang off (an operator may remap it at install) and the `paths` it registers.
+ */
+export declare const marketplaceRoutesDecl: z.ZodObject<{
+    base: z.ZodString;
+    paths: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+        public: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        public: boolean;
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+    }, {
+        path: string;
+        public: boolean;
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    base: string;
+    paths: {
+        path: string;
+        public: boolean;
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+    }[];
+}, {
+    base: string;
+    paths: {
+        path: string;
+        public: boolean;
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+    }[];
+}>;
+export type MarketplaceRoutesDecl = z.infer<typeof marketplaceRoutesDecl>;
 /**
  * One contained item of a marketplace plugin's published version: its kind
  * (tool / agent / extension / …), name, description, free-form tags, and the
- * logical group it belongs to (`null` when ungrouped).
+ * logical group it belongs to (`null` when ungrouped). `routes` is present only
+ * on a route-carrying item (a router or channel); absent/null on every other.
  */
 export declare const marketplaceItem: z.ZodObject<{
     kind: z.ZodString;
@@ -7001,18 +7226,64 @@ export declare const marketplaceItem: z.ZodObject<{
     description: z.ZodString;
     tags: z.ZodArray<z.ZodString, "many">;
     group: z.ZodNullable<z.ZodString>;
+    routes: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        base: z.ZodString;
+        paths: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+            public: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            public: boolean;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        }, {
+            path: string;
+            public: boolean;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        base: string;
+        paths: {
+            path: string;
+            public: boolean;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        }[];
+    }, {
+        base: string;
+        paths: {
+            path: string;
+            public: boolean;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        }[];
+    }>>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     description: string;
     tags: string[];
     kind: string;
     group: string | null;
+    routes?: {
+        base: string;
+        paths: {
+            path: string;
+            public: boolean;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        }[];
+    } | null | undefined;
 }, {
     name: string;
     description: string;
     tags: string[];
     kind: string;
     group: string | null;
+    routes?: {
+        base: string;
+        paths: {
+            path: string;
+            public: boolean;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        }[];
+    } | null | undefined;
 }>;
 export type MarketplaceItem = z.infer<typeof marketplaceItem>;
 /**
@@ -7356,18 +7627,64 @@ export declare const marketplaceLatestVersion: z.ZodObject<{
         description: z.ZodString;
         tags: z.ZodArray<z.ZodString, "many">;
         group: z.ZodNullable<z.ZodString>;
+        routes: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            base: z.ZodString;
+            paths: z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+                public: z.ZodBoolean;
+            }, "strip", z.ZodTypeAny, {
+                path: string;
+                public: boolean;
+                methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            }, {
+                path: string;
+                public: boolean;
+                methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            base: string;
+            paths: {
+                path: string;
+                public: boolean;
+                methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            }[];
+        }, {
+            base: string;
+            paths: {
+                path: string;
+                public: boolean;
+                methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            }[];
+        }>>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         description: string;
         tags: string[];
         kind: string;
         group: string | null;
+        routes?: {
+            base: string;
+            paths: {
+                path: string;
+                public: boolean;
+                methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            }[];
+        } | null | undefined;
     }, {
         name: string;
         description: string;
         tags: string[];
         kind: string;
         group: string | null;
+        routes?: {
+            base: string;
+            paths: {
+                path: string;
+                public: boolean;
+                methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            }[];
+        } | null | undefined;
     }>, "many">;
     spec: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         provides: z.ZodArray<z.ZodObject<{
@@ -7474,6 +7791,14 @@ export declare const marketplaceLatestVersion: z.ZodObject<{
         tags: string[];
         kind: string;
         group: string | null;
+        routes?: {
+            base: string;
+            paths: {
+                path: string;
+                public: boolean;
+                methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            }[];
+        } | null | undefined;
     }[];
     version: string;
     contract_range: string | null;
@@ -7519,6 +7844,14 @@ export declare const marketplaceLatestVersion: z.ZodObject<{
         tags: string[];
         kind: string;
         group: string | null;
+        routes?: {
+            base: string;
+            paths: {
+                path: string;
+                public: boolean;
+                methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            }[];
+        } | null | undefined;
     }[];
     version: string;
     contract_range: string | null;
@@ -7620,18 +7953,64 @@ export declare const marketplacePluginDetail: z.ZodObject<{
             description: z.ZodString;
             tags: z.ZodArray<z.ZodString, "many">;
             group: z.ZodNullable<z.ZodString>;
+            routes: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                base: z.ZodString;
+                paths: z.ZodArray<z.ZodObject<{
+                    path: z.ZodString;
+                    methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+                    public: z.ZodBoolean;
+                }, "strip", z.ZodTypeAny, {
+                    path: string;
+                    public: boolean;
+                    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                }, {
+                    path: string;
+                    public: boolean;
+                    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                }>, "many">;
+            }, "strip", z.ZodTypeAny, {
+                base: string;
+                paths: {
+                    path: string;
+                    public: boolean;
+                    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                }[];
+            }, {
+                base: string;
+                paths: {
+                    path: string;
+                    public: boolean;
+                    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                }[];
+            }>>>;
         }, "strip", z.ZodTypeAny, {
             name: string;
             description: string;
             tags: string[];
             kind: string;
             group: string | null;
+            routes?: {
+                base: string;
+                paths: {
+                    path: string;
+                    public: boolean;
+                    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                }[];
+            } | null | undefined;
         }, {
             name: string;
             description: string;
             tags: string[];
             kind: string;
             group: string | null;
+            routes?: {
+                base: string;
+                paths: {
+                    path: string;
+                    public: boolean;
+                    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                }[];
+            } | null | undefined;
         }>, "many">;
         spec: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             provides: z.ZodArray<z.ZodObject<{
@@ -7738,6 +8117,14 @@ export declare const marketplacePluginDetail: z.ZodObject<{
             tags: string[];
             kind: string;
             group: string | null;
+            routes?: {
+                base: string;
+                paths: {
+                    path: string;
+                    public: boolean;
+                    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                }[];
+            } | null | undefined;
         }[];
         version: string;
         contract_range: string | null;
@@ -7783,6 +8170,14 @@ export declare const marketplacePluginDetail: z.ZodObject<{
             tags: string[];
             kind: string;
             group: string | null;
+            routes?: {
+                base: string;
+                paths: {
+                    path: string;
+                    public: boolean;
+                    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                }[];
+            } | null | undefined;
         }[];
         version: string;
         contract_range: string | null;
@@ -7867,6 +8262,14 @@ export declare const marketplacePluginDetail: z.ZodObject<{
             tags: string[];
             kind: string;
             group: string | null;
+            routes?: {
+                base: string;
+                paths: {
+                    path: string;
+                    public: boolean;
+                    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                }[];
+            } | null | undefined;
         }[];
         version: string;
         contract_range: string | null;
@@ -7937,6 +8340,14 @@ export declare const marketplacePluginDetail: z.ZodObject<{
             tags: string[];
             kind: string;
             group: string | null;
+            routes?: {
+                base: string;
+                paths: {
+                    path: string;
+                    public: boolean;
+                    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                }[];
+            } | null | undefined;
         }[];
         version: string;
         contract_range: string | null;
@@ -8033,6 +8444,36 @@ export declare const marketplaceInstalledPlugin: z.ZodObject<{
         description: z.ZodString;
         tags: z.ZodArray<z.ZodString, "many">;
         group: z.ZodNullable<z.ZodString>;
+        routes: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            base: z.ZodString;
+            paths: z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+                public: z.ZodBoolean;
+            }, "strip", z.ZodTypeAny, {
+                path: string;
+                public: boolean;
+                methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            }, {
+                path: string;
+                public: boolean;
+                methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            base: string;
+            paths: {
+                path: string;
+                public: boolean;
+                methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            }[];
+        }, {
+            base: string;
+            paths: {
+                path: string;
+                public: boolean;
+                methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            }[];
+        }>>>;
     }, "name" | "kind">, "strip", z.ZodTypeAny, {
         name: string;
         kind: string;
@@ -8040,6 +8481,7 @@ export declare const marketplaceInstalledPlugin: z.ZodObject<{
         name: string;
         kind: string;
     }>, "many">;
+    route_mounts: z.ZodRecord<z.ZodString, z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     items: {
         name: string;
@@ -8057,6 +8499,7 @@ export declare const marketplaceInstalledPlugin: z.ZodObject<{
         status: "unknown" | "compatible" | "incompatible";
         reason: string | null;
     };
+    route_mounts: Record<string, string>;
 }, {
     items: {
         name: string;
@@ -8074,6 +8517,7 @@ export declare const marketplaceInstalledPlugin: z.ZodObject<{
         status: "unknown" | "compatible" | "incompatible";
         reason: string | null;
     };
+    route_mounts: Record<string, string>;
 }>;
 export type MarketplaceInstalledPlugin = z.infer<typeof marketplaceInstalledPlugin>;
 /** One plugin the boot pass quarantined instead of loading, with why. CLOSED. */
@@ -8118,6 +8562,36 @@ export declare const marketplaceInstalled: z.ZodObject<{
             description: z.ZodString;
             tags: z.ZodArray<z.ZodString, "many">;
             group: z.ZodNullable<z.ZodString>;
+            routes: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                base: z.ZodString;
+                paths: z.ZodArray<z.ZodObject<{
+                    path: z.ZodString;
+                    methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+                    public: z.ZodBoolean;
+                }, "strip", z.ZodTypeAny, {
+                    path: string;
+                    public: boolean;
+                    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                }, {
+                    path: string;
+                    public: boolean;
+                    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                }>, "many">;
+            }, "strip", z.ZodTypeAny, {
+                base: string;
+                paths: {
+                    path: string;
+                    public: boolean;
+                    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                }[];
+            }, {
+                base: string;
+                paths: {
+                    path: string;
+                    public: boolean;
+                    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+                }[];
+            }>>>;
         }, "name" | "kind">, "strip", z.ZodTypeAny, {
             name: string;
             kind: string;
@@ -8125,6 +8599,7 @@ export declare const marketplaceInstalled: z.ZodObject<{
             name: string;
             kind: string;
         }>, "many">;
+        route_mounts: z.ZodRecord<z.ZodString, z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         items: {
             name: string;
@@ -8142,6 +8617,7 @@ export declare const marketplaceInstalled: z.ZodObject<{
             status: "unknown" | "compatible" | "incompatible";
             reason: string | null;
         };
+        route_mounts: Record<string, string>;
     }, {
         items: {
             name: string;
@@ -8159,6 +8635,7 @@ export declare const marketplaceInstalled: z.ZodObject<{
             status: "unknown" | "compatible" | "incompatible";
             reason: string | null;
         };
+        route_mounts: Record<string, string>;
     }>, "many">;
     quarantined: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -8188,6 +8665,7 @@ export declare const marketplaceInstalled: z.ZodObject<{
             status: "unknown" | "compatible" | "incompatible";
             reason: string | null;
         };
+        route_mounts: Record<string, string>;
     }[];
     quarantined: {
         name: string;
@@ -8211,6 +8689,7 @@ export declare const marketplaceInstalled: z.ZodObject<{
             status: "unknown" | "compatible" | "incompatible";
             reason: string | null;
         };
+        route_mounts: Record<string, string>;
     }[];
     quarantined: {
         name: string;
@@ -8321,13 +8800,36 @@ export declare const marketplaceAdvisories: z.ZodObject<{
 export declare const marketplaceCategories: z.ZodArray<z.ZodString, "many">;
 /** The registry's controlled item-kind list, proxied through the skeleton. */
 export declare const marketplaceKinds: z.ZodArray<z.ZodString, "many">;
+/**
+ * One route the install / update actually mounted: the item that owns it, the
+ * absolute `full_path` it now answers, the `methods`, and whether it is served
+ * `public`. The receipt lists these so the operator sees what was opened where.
+ */
+export declare const marketplaceMountedRoute: z.ZodObject<{
+    item: z.ZodString;
+    full_path: z.ZodString;
+    methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+    public: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    public: boolean;
+    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+    item: string;
+    full_path: string;
+}, {
+    public: boolean;
+    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+    item: string;
+    full_path: string;
+}>;
+export type MarketplaceMountedRoute = z.infer<typeof marketplaceMountedRoute>;
 /**
  * The receipt of an install / update: what landed and at which version.
  * `notes` (env-selected items naming their activating env var) and any
- * non-critical `advisories` ride BOTH the install and update receipts. The wire
- * also carries `package`, `reload`, and `pip_output`, which the receipt does not
- * model — zod's default strip drops them; the UI renders the receipt, not the
- * raw install log.
+ * non-critical `advisories` ride BOTH the install and update receipts.
+ * `routes` is the mounted-route list — empty for a plugin that registers none.
+ * The wire also carries `package`, `reload`, and `pip_output`, which the receipt
+ * does not model — zod's default strip drops them; the UI renders the receipt,
+ * not the raw install log.
  */
 export declare const marketplaceInstallResult: z.ZodObject<{
     ref: z.ZodString;
@@ -8358,8 +8860,30 @@ export declare const marketplaceInstallResult: z.ZodObject<{
         severity: string;
         withdrawn_at: string | null;
     }>, "many">;
+    routes: z.ZodArray<z.ZodObject<{
+        item: z.ZodString;
+        full_path: z.ZodString;
+        methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+        public: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        public: boolean;
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+    }, {
+        public: boolean;
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+    }>, "many">;
 }, "strip", z.ZodTypeAny, {
     version: string;
+    routes: {
+        public: boolean;
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+    }[];
     ref: string;
     advisories: {
         created_at: string;
@@ -8373,6 +8897,12 @@ export declare const marketplaceInstallResult: z.ZodObject<{
     notes: string[];
 }, {
     version: string;
+    routes: {
+        public: boolean;
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+    }[];
     ref: string;
     advisories: {
         created_at: string;
@@ -8386,6 +8916,280 @@ export declare const marketplaceInstallResult: z.ZodObject<{
     notes: string[];
 }>;
 export type MarketplaceInstallResult = z.infer<typeof marketplaceInstallResult>;
+/** One resolved route in an install preview: the declared `path`, its resolved
+ * absolute `full_path`, the `methods`, and whether it is `public`. */
+export declare const marketplacePreviewRoute: z.ZodObject<{
+    path: z.ZodString;
+    full_path: z.ZodString;
+    methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+    public: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    public: boolean;
+    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+    full_path: string;
+}, {
+    path: string;
+    public: boolean;
+    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+    full_path: string;
+}>;
+export type MarketplacePreviewRoute = z.infer<typeof marketplacePreviewRoute>;
+/** One route-carrying item in an install preview: its resolved `base` (the
+ * override or the default), the `default_base` it declares, and the routes that
+ * mount under it. */
+export declare const marketplacePreviewItem: z.ZodObject<{
+    item: z.ZodString;
+    kind: z.ZodString;
+    base: z.ZodString;
+    default_base: z.ZodString;
+    routes: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        full_path: z.ZodString;
+        methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+        public: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        public: boolean;
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        full_path: string;
+    }, {
+        path: string;
+        public: boolean;
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        full_path: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    kind: string;
+    routes: {
+        path: string;
+        public: boolean;
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        full_path: string;
+    }[];
+    base: string;
+    item: string;
+    default_base: string;
+}, {
+    kind: string;
+    routes: {
+        path: string;
+        public: boolean;
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        full_path: string;
+    }[];
+    base: string;
+    item: string;
+    default_base: string;
+}>;
+export type MarketplacePreviewItem = z.infer<typeof marketplacePreviewItem>;
+/** One collision the preview found: a route whose resolved shape+method clashes
+ * with an already-owned route. `conflict_owner` is `core` or `plugin:<ref>`; the
+ * remedy is to remap the item's base. */
+export declare const marketplacePreviewCollision: z.ZodObject<{
+    item: z.ZodString;
+    full_path: z.ZodString;
+    methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+    conflict_owner: z.ZodString;
+    conflict_path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+    item: string;
+    full_path: string;
+    conflict_owner: string;
+    conflict_path: string;
+}, {
+    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+    item: string;
+    full_path: string;
+    conflict_owner: string;
+    conflict_path: string;
+}>;
+export type MarketplacePreviewCollision = z.infer<typeof marketplacePreviewCollision>;
+/** One public route the operator is asked to accept: served WITHOUT
+ * authentication once installed. */
+export declare const marketplacePreviewPublicRoute: z.ZodObject<{
+    item: z.ZodString;
+    full_path: z.ZodString;
+    methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+    item: string;
+    full_path: string;
+}, {
+    methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+    item: string;
+    full_path: string;
+}>;
+export type MarketplacePreviewPublicRoute = z.infer<typeof marketplacePreviewPublicRoute>;
+/**
+ * The install preview (`POST /api/marketplace/install/preview`): the resolved
+ * routes per item with any base overrides applied, the collisions against the
+ * live registry, the public routes requiring acceptance, and whether acceptance
+ * is required at all. `new_public_routes` narrows to rows not already approved
+ * (the update case); on a fresh install it equals `public_routes`.
+ */
+export declare const marketplaceInstallPreview: z.ZodObject<{
+    ref: z.ZodString;
+    version: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        item: z.ZodString;
+        kind: z.ZodString;
+        base: z.ZodString;
+        default_base: z.ZodString;
+        routes: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            full_path: z.ZodString;
+            methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+            public: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            public: boolean;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            full_path: string;
+        }, {
+            path: string;
+            public: boolean;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            full_path: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+        routes: {
+            path: string;
+            public: boolean;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            full_path: string;
+        }[];
+        base: string;
+        item: string;
+        default_base: string;
+    }, {
+        kind: string;
+        routes: {
+            path: string;
+            public: boolean;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            full_path: string;
+        }[];
+        base: string;
+        item: string;
+        default_base: string;
+    }>, "many">;
+    collisions: z.ZodArray<z.ZodObject<{
+        item: z.ZodString;
+        full_path: z.ZodString;
+        methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+        conflict_owner: z.ZodString;
+        conflict_path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+        conflict_owner: string;
+        conflict_path: string;
+    }, {
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+        conflict_owner: string;
+        conflict_path: string;
+    }>, "many">;
+    public_routes: z.ZodArray<z.ZodObject<{
+        item: z.ZodString;
+        full_path: z.ZodString;
+        methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+    }, {
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+    }>, "many">;
+    new_public_routes: z.ZodArray<z.ZodObject<{
+        item: z.ZodString;
+        full_path: z.ZodString;
+        methods: z.ZodArray<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+    }, {
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+    }>, "many">;
+    requires_public_acceptance: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        kind: string;
+        routes: {
+            path: string;
+            public: boolean;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            full_path: string;
+        }[];
+        base: string;
+        item: string;
+        default_base: string;
+    }[];
+    version: string;
+    ref: string;
+    collisions: {
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+        conflict_owner: string;
+        conflict_path: string;
+    }[];
+    public_routes: {
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+    }[];
+    new_public_routes: {
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+    }[];
+    requires_public_acceptance: boolean;
+}, {
+    items: {
+        kind: string;
+        routes: {
+            path: string;
+            public: boolean;
+            methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+            full_path: string;
+        }[];
+        base: string;
+        item: string;
+        default_base: string;
+    }[];
+    version: string;
+    ref: string;
+    collisions: {
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+        conflict_owner: string;
+        conflict_path: string;
+    }[];
+    public_routes: {
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+    }[];
+    new_public_routes: {
+        methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+        item: string;
+        full_path: string;
+    }[];
+    requires_public_acceptance: boolean;
+}>;
+export type MarketplaceInstallPreview = z.infer<typeof marketplaceInstallPreview>;
 /**
  * The receipt of an uninstall. `notes` carries operator warnings (e.g. a config
  * provider still selected by its env var); render them like the install