@tai42/api-client 1.9.0 → 3.0.0

package/dist/schemas.d.ts

@@ -6990,10 +6990,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 +7065,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 +7466,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 +7630,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 +7683,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 +7792,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 +7956,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 +8009,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 +8101,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 +8179,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 +8283,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 +8320,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 +8338,7 @@ export declare const marketplaceInstalledPlugin: z.ZodObject<{
         status: "unknown" | "compatible" | "incompatible";
         reason: string | null;
     };
+    route_mounts: Record<string, string>;
 }, {
     items: {
         name: string;
@@ -8074,6 +8356,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 +8401,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 +8438,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 +8456,7 @@ export declare const marketplaceInstalled: z.ZodObject<{
             status: "unknown" | "compatible" | "incompatible";
             reason: string | null;
         };
+        route_mounts: Record<string, string>;
     }, {
         items: {
             name: string;
@@ -8159,6 +8474,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 +8504,7 @@ export declare const marketplaceInstalled: z.ZodObject<{
             status: "unknown" | "compatible" | "incompatible";
             reason: string | null;
         };
+        route_mounts: Record<string, string>;
     }[];
     quarantined: {
         name: string;
@@ -8211,6 +8528,7 @@ export declare const marketplaceInstalled: z.ZodObject<{
             status: "unknown" | "compatible" | "incompatible";
             reason: string | null;
         };
+        route_mounts: Record<string, string>;
     }[];
     quarantined: {
         name: string;
@@ -8321,13 +8639,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 +8699,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 +8736,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 +8755,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