npm - @tai42/api-client - Versions diffs - 4.0.0 → 5.0.0 - Mend

@tai42/api-client 4.0.0 → 5.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/dist/schemas.d.ts CHANGED Viewed

@@ -7159,6 +7159,37 @@ export type RunTrace = z.infer<typeof runTrace>;
  */
 export declare const routeMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>;
 export type RouteMethod = z.infer<typeof routeMethod>;
+/**
+ * How the plugin is delivered, derived server-side from whether its spec names a
+ * package: `package` is pip-installed, `descriptor` (marketplace `source` `spec`)
+ * installs nothing but the manifest entry. A CLOSED enum, so a wire value the
+ * server does not derive fails loudly as drift.
+ */
+export declare const marketplaceDelivery: z.ZodEnum<["package", "descriptor"]>;
+export type MarketplaceDelivery = z.infer<typeof marketplaceDelivery>;
+/**
+ * The install-provenance vocabulary a listing/version resolves from: a pip index
+ * (`pypi`), a git tag (`github`), or a descriptor yml (`spec`). CLOSED, so a wire
+ * value outside it fails as drift.
+ */
+export declare const marketplaceSource: z.ZodEnum<["pypi", "github", "spec"]>;
+export type MarketplaceSource = z.infer<typeof marketplaceSource>;
+/**
+ * One env var an item requires before install: its `name` and whether its value is
+ * a `secret` (an OAuth client secret is; a client id or a plain marker var is not).
+ * The install dialog seeds each toggle from `secret` and collects the missing ones.
+ */
+export declare const marketplaceRequiredEnvVar: z.ZodObject<{
+    name: z.ZodString;
+    secret: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    secret: boolean;
+}, {
+    name: string;
+    secret: boolean;
+}>;
+export type MarketplaceRequiredEnvVar = z.infer<typeof marketplaceRequiredEnvVar>;
 /**
  * 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
@@ -7219,6 +7250,12 @@ export type MarketplaceRoutesDecl = z.infer<typeof marketplaceRoutesDecl>;
  * (tool / agent / extension / …), name, description, free-form tags, and the
  * 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.
+ * `required_env` is the env vars the item needs before install — but the REGISTRY's
+ * plugin-detail body does NOT carry it per item: required-env is server-computed
+ * (`required_env_for_spec`) and rides the install PREVIEW, never the listing detail,
+ * so the registry OMITS it here and it parses as `undefined`. Optional (not
+ * defaulted) so the type mirrors the wire; the authority the install dialog collects
+ * from is the preview's `required_env`/`missing_env`, never this field.
  */
 export declare const marketplaceItem: z.ZodObject<{
     kind: z.ZodString;
@@ -7256,6 +7293,16 @@ export declare const marketplaceItem: z.ZodObject<{
             methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
         }[];
     }>>>;
+    required_env: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        secret: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        secret: boolean;
+    }, {
+        name: string;
+        secret: boolean;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     description: string;
@@ -7270,6 +7317,10 @@ export declare const marketplaceItem: z.ZodObject<{
             methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
         }[];
     } | null | undefined;
+    required_env?: {
+        name: string;
+        secret: boolean;
+    }[] | undefined;
 }, {
     name: string;
     description: string;
@@ -7284,6 +7335,10 @@ export declare const marketplaceItem: z.ZodObject<{
             methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
         }[];
     } | null | undefined;
+    required_env?: {
+        name: string;
+        secret: boolean;
+    }[] | undefined;
 }>;
 export type MarketplaceItem = z.infer<typeof marketplaceItem>;
 /**
@@ -7336,7 +7391,7 @@ export declare const marketplaceSearchRow: z.ZodObject<{
     name: z.ZodString;
     display_name: z.ZodNullable<z.ZodString>;
     icon_url: z.ZodNullable<z.ZodString>;
-    package: z.ZodString;
+    package: z.ZodNullable<z.ZodString>;
     description: z.ZodString;
     categories: z.ZodArray<z.ZodString, "many">;
     tags: z.ZodArray<z.ZodString, "many">;
@@ -7381,9 +7436,9 @@ export declare const marketplaceSearchRow: z.ZodObject<{
         name: string;
         count: number;
     }[];
+    package: string | null;
     ref: string;
     namespace: string;
-    package: string;
     trust_tier: string;
     pricing: string;
     latest_version: string | null;
@@ -7406,9 +7461,9 @@ export declare const marketplaceSearchRow: z.ZodObject<{
         name: string;
         count: number;
     }[];
+    package: string | null;
     ref: string;
     namespace: string;
-    package: string;
     trust_tier: string;
     pricing: string;
     latest_version: string | null;
@@ -7432,7 +7487,7 @@ export declare const marketplaceSearchPage: z.ZodObject<{
         name: z.ZodString;
         display_name: z.ZodNullable<z.ZodString>;
         icon_url: z.ZodNullable<z.ZodString>;
-        package: z.ZodString;
+        package: z.ZodNullable<z.ZodString>;
         description: z.ZodString;
         categories: z.ZodArray<z.ZodString, "many">;
         tags: z.ZodArray<z.ZodString, "many">;
@@ -7477,9 +7532,9 @@ export declare const marketplaceSearchPage: z.ZodObject<{
             name: string;
             count: number;
         }[];
+        package: string | null;
         ref: string;
         namespace: string;
-        package: string;
         trust_tier: string;
         pricing: string;
         latest_version: string | null;
@@ -7502,9 +7557,9 @@ export declare const marketplaceSearchPage: z.ZodObject<{
             name: string;
             count: number;
         }[];
+        package: string | null;
         ref: string;
         namespace: string;
-        package: string;
         trust_tier: string;
         pricing: string;
         latest_version: string | null;
@@ -7535,9 +7590,9 @@ export declare const marketplaceSearchPage: z.ZodObject<{
             name: string;
             count: number;
         }[];
+        package: string | null;
         ref: string;
         namespace: string;
-        package: string;
         trust_tier: string;
         pricing: string;
         latest_version: string | null;
@@ -7565,9 +7620,9 @@ export declare const marketplaceSearchPage: z.ZodObject<{
             name: string;
             count: number;
         }[];
+        package: string | null;
         ref: string;
         namespace: string;
-        package: string;
         trust_tier: string;
         pricing: string;
         latest_version: string | null;
@@ -7605,15 +7660,13 @@ export declare const marketplaceVersion: z.ZodObject<{
 }>;
 export type MarketplaceVersion = z.infer<typeof marketplaceVersion>;
 /**
- * The listing's latest published version as embedded in its detail: the version,
- * the items it contains, and a minimal typed passthrough of the published spec.
- *
- * `spec` is carried so the install dialog can read an mcp-server item's public
- * `mcp.env` marker strings (`provides[].mcp.env`) and collect its required `!ENV`
- * vars before install. Only that path is typed; everything else on the spec is
- * `.passthrough()`-preserved but unmodelled (zod would otherwise strip the whole
- * `spec` as an unknown key). Nullable + optional: a listing with nothing published
- * carries no spec.
+ * The listing's latest published version as embedded in its detail: the version
+ * (with the `marketplaceVersion` lifecycle fields) and the items it contains. The
+ * registry's detail body carries NO per-version `delivery` field — delivery is
+ * server-computed from whether the spec names a package, and the detail surface
+ * derives it from the listing's `package` (null ⇒ `descriptor`, else `package`).
+ * Env to collect comes from the install preview (`required_env` / `missing_env`),
+ * never from these items.
  */
 export declare const marketplaceLatestVersion: z.ZodObject<{
     version: z.ZodString;
@@ -7657,6 +7710,16 @@ export declare const marketplaceLatestVersion: z.ZodObject<{
                 methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
             }[];
         }>>>;
+        required_env: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            secret: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            secret: boolean;
+        }, {
+            name: string;
+            secret: boolean;
+        }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         description: string;
@@ -7671,6 +7734,10 @@ export declare const marketplaceLatestVersion: z.ZodObject<{
                 methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
             }[];
         } | null | undefined;
+        required_env?: {
+            name: string;
+            secret: boolean;
+        }[] | undefined;
     }, {
         name: string;
         description: string;
@@ -7685,104 +7752,11 @@ export declare const marketplaceLatestVersion: z.ZodObject<{
                 methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
             }[];
         } | null | undefined;
+        required_env?: {
+            name: string;
+            secret: boolean;
+        }[] | undefined;
     }>, "many">;
-    spec: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        provides: z.ZodArray<z.ZodObject<{
-            kind: z.ZodString;
-            name: z.ZodString;
-            mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            kind: z.ZodString;
-            name: z.ZodString;
-            mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            kind: z.ZodString;
-            name: z.ZodString;
-            mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, z.ZodTypeAny, "passthrough">>, "many">;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        provides: z.ZodArray<z.ZodObject<{
-            kind: z.ZodString;
-            name: z.ZodString;
-            mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            kind: z.ZodString;
-            name: z.ZodString;
-            mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            kind: z.ZodString;
-            name: z.ZodString;
-            mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, z.ZodTypeAny, "passthrough">>, "many">;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        provides: z.ZodArray<z.ZodObject<{
-            kind: z.ZodString;
-            name: z.ZodString;
-            mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            kind: z.ZodString;
-            name: z.ZodString;
-            mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            kind: z.ZodString;
-            name: z.ZodString;
-            mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, z.ZodTypeAny, "passthrough">>, "many">;
-    }, z.ZodTypeAny, "passthrough">>>>;
 }, "strip", z.ZodTypeAny, {
     status: string;
     items: {
@@ -7799,43 +7773,14 @@ export declare const marketplaceLatestVersion: z.ZodObject<{
                 methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
             }[];
         } | null | undefined;
+        required_env?: {
+            name: string;
+            secret: boolean;
+        }[] | undefined;
     }[];
     version: string;
     contract_range: string | null;
     published_at: string | null;
-    spec?: z.objectOutputType<{
-        provides: z.ZodArray<z.ZodObject<{
-            kind: z.ZodString;
-            name: z.ZodString;
-            mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            kind: z.ZodString;
-            name: z.ZodString;
-            mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            kind: z.ZodString;
-            name: z.ZodString;
-            mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, z.ZodTypeAny, "passthrough">>, "many">;
-    }, z.ZodTypeAny, "passthrough"> | null | undefined;
 }, {
     status: string;
     items: {
@@ -7852,43 +7797,14 @@ export declare const marketplaceLatestVersion: z.ZodObject<{
                 methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
             }[];
         } | null | undefined;
+        required_env?: {
+            name: string;
+            secret: boolean;
+        }[] | undefined;
     }[];
     version: string;
     contract_range: string | null;
     published_at: string | null;
-    spec?: z.objectInputType<{
-        provides: z.ZodArray<z.ZodObject<{
-            kind: z.ZodString;
-            name: z.ZodString;
-            mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            kind: z.ZodString;
-            name: z.ZodString;
-            mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            kind: z.ZodString;
-            name: z.ZodString;
-            mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-            }, z.ZodTypeAny, "passthrough">>>>;
-        }, z.ZodTypeAny, "passthrough">>, "many">;
-    }, z.ZodTypeAny, "passthrough"> | null | undefined;
 }>;
 export type MarketplaceLatestVersion = z.infer<typeof marketplaceLatestVersion>;
 /** One advisory row; `withdrawn_at` non-null means it no longer applies. */
@@ -7928,7 +7844,8 @@ export declare const marketplacePluginDetail: z.ZodObject<{
     name: z.ZodString;
     display_name: z.ZodNullable<z.ZodString>;
     icon_url: z.ZodNullable<z.ZodString>;
-    package: z.ZodString;
+    package: z.ZodNullable<z.ZodString>;
+    source: z.ZodOptional<z.ZodNullable<z.ZodEnum<["pypi", "github", "spec"]>>>;
     description: z.ZodString;
     readme_md: z.ZodNullable<z.ZodString>;
     license: z.ZodNullable<z.ZodString>;
@@ -7983,6 +7900,16 @@ export declare const marketplacePluginDetail: z.ZodObject<{
                     methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
                 }[];
             }>>>;
+            required_env: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                secret: z.ZodBoolean;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                secret: boolean;
+            }, {
+                name: string;
+                secret: boolean;
+            }>, "many">>;
         }, "strip", z.ZodTypeAny, {
             name: string;
             description: string;
@@ -7997,6 +7924,10 @@ export declare const marketplacePluginDetail: z.ZodObject<{
                     methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
                 }[];
             } | null | undefined;
+            required_env?: {
+                name: string;
+                secret: boolean;
+            }[] | undefined;
         }, {
             name: string;
             description: string;
@@ -8011,104 +7942,11 @@ export declare const marketplacePluginDetail: z.ZodObject<{
                     methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
                 }[];
             } | null | undefined;
+            required_env?: {
+                name: string;
+                secret: boolean;
+            }[] | undefined;
         }>, "many">;
-        spec: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-            provides: z.ZodArray<z.ZodObject<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, z.ZodTypeAny, "passthrough">>, "many">;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            provides: z.ZodArray<z.ZodObject<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, z.ZodTypeAny, "passthrough">>, "many">;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            provides: z.ZodArray<z.ZodObject<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, z.ZodTypeAny, "passthrough">>, "many">;
-        }, z.ZodTypeAny, "passthrough">>>>;
     }, "strip", z.ZodTypeAny, {
         status: string;
         items: {
@@ -8125,43 +7963,14 @@ export declare const marketplacePluginDetail: z.ZodObject<{
                     methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
                 }[];
             } | null | undefined;
+            required_env?: {
+                name: string;
+                secret: boolean;
+            }[] | undefined;
         }[];
         version: string;
         contract_range: string | null;
         published_at: string | null;
-        spec?: z.objectOutputType<{
-            provides: z.ZodArray<z.ZodObject<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, z.ZodTypeAny, "passthrough">>, "many">;
-        }, z.ZodTypeAny, "passthrough"> | null | undefined;
     }, {
         status: string;
         items: {
@@ -8178,43 +7987,14 @@ export declare const marketplacePluginDetail: z.ZodObject<{
                     methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
                 }[];
             } | null | undefined;
+            required_env?: {
+                name: string;
+                secret: boolean;
+            }[] | undefined;
         }[];
         version: string;
         contract_range: string | null;
         published_at: string | null;
-        spec?: z.objectInputType<{
-            provides: z.ZodArray<z.ZodObject<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, z.ZodTypeAny, "passthrough">>, "many">;
-        }, z.ZodTypeAny, "passthrough"> | null | undefined;
     }>>;
     versions: z.ZodArray<z.ZodObject<{
         version: z.ZodString;
@@ -8245,8 +8025,8 @@ export declare const marketplacePluginDetail: z.ZodObject<{
         contract_range: string | null;
         published_at: string | null;
     }[];
+    package: string | null;
     namespace: string;
-    package: string;
     trust_tier: string;
     pricing: string;
     downloads: number;
@@ -8270,44 +8050,16 @@ export declare const marketplacePluginDetail: z.ZodObject<{
                     methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
                 }[];
             } | null | undefined;
+            required_env?: {
+                name: string;
+                secret: boolean;
+            }[] | undefined;
         }[];
         version: string;
         contract_range: string | null;
         published_at: string | null;
-        spec?: z.objectOutputType<{
-            provides: z.ZodArray<z.ZodObject<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, z.ZodTypeAny, "passthrough">>, "many">;
-        }, z.ZodTypeAny, "passthrough"> | null | undefined;
     } | null;
+    source?: "pypi" | "github" | "spec" | null | undefined;
     premium?: boolean | null | undefined;
     docs_url?: string | null | undefined;
 }, {
@@ -8323,8 +8075,8 @@ export declare const marketplacePluginDetail: z.ZodObject<{
         contract_range: string | null;
         published_at: string | null;
     }[];
+    package: string | null;
     namespace: string;
-    package: string;
     trust_tier: string;
     pricing: string;
     downloads: number;
@@ -8348,44 +8100,16 @@ export declare const marketplacePluginDetail: z.ZodObject<{
                     methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
                 }[];
             } | null | undefined;
+            required_env?: {
+                name: string;
+                secret: boolean;
+            }[] | undefined;
         }[];
         version: string;
         contract_range: string | null;
         published_at: string | null;
-        spec?: z.objectInputType<{
-            provides: z.ZodArray<z.ZodObject<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                kind: z.ZodString;
-                name: z.ZodString;
-                mcp: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    env: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-                }, z.ZodTypeAny, "passthrough">>>>;
-            }, z.ZodTypeAny, "passthrough">>, "many">;
-        }, z.ZodTypeAny, "passthrough"> | null | undefined;
     } | null;
+    source?: "pypi" | "github" | "spec" | null | undefined;
     premium?: boolean | null | undefined;
     docs_url?: string | null | undefined;
 }>;
@@ -8423,6 +8147,7 @@ export declare const marketplaceInstalledPlugin: z.ZodObject<{
     ref: z.ZodString;
     version: z.ZodString;
     source: z.ZodString;
+    delivery: z.ZodEnum<["package", "descriptor"]>;
     installed_at: z.ZodString;
     latest: z.ZodNullable<z.ZodString>;
     update_available: z.ZodBoolean;
@@ -8474,6 +8199,16 @@ export declare const marketplaceInstalledPlugin: z.ZodObject<{
                 methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
             }[];
         }>>>;
+        required_env: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            secret: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            secret: boolean;
+        }, {
+            name: string;
+            secret: boolean;
+        }>, "many">>;
     }, "name" | "kind">, "strip", z.ZodTypeAny, {
         name: string;
         kind: string;
@@ -8491,6 +8226,7 @@ export declare const marketplaceInstalledPlugin: z.ZodObject<{
     source: string;
     ref: string;
     latest: string | null;
+    delivery: "package" | "descriptor";
     installed_at: string;
     update_available: boolean;
     incompatible_newer: string | null;
@@ -8509,6 +8245,7 @@ export declare const marketplaceInstalledPlugin: z.ZodObject<{
     source: string;
     ref: string;
     latest: string | null;
+    delivery: "package" | "descriptor";
     installed_at: string;
     update_available: boolean;
     incompatible_newer: string | null;
@@ -8541,6 +8278,7 @@ export declare const marketplaceInstalled: z.ZodObject<{
         ref: z.ZodString;
         version: z.ZodString;
         source: z.ZodString;
+        delivery: z.ZodEnum<["package", "descriptor"]>;
         installed_at: z.ZodString;
         latest: z.ZodNullable<z.ZodString>;
         update_available: z.ZodBoolean;
@@ -8592,6 +8330,16 @@ export declare const marketplaceInstalled: z.ZodObject<{
                     methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
                 }[];
             }>>>;
+            required_env: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                secret: z.ZodBoolean;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                secret: boolean;
+            }, {
+                name: string;
+                secret: boolean;
+            }>, "many">>;
         }, "name" | "kind">, "strip", z.ZodTypeAny, {
             name: string;
             kind: string;
@@ -8609,6 +8357,7 @@ export declare const marketplaceInstalled: z.ZodObject<{
         source: string;
         ref: string;
         latest: string | null;
+        delivery: "package" | "descriptor";
         installed_at: string;
         update_available: boolean;
         incompatible_newer: string | null;
@@ -8627,6 +8376,7 @@ export declare const marketplaceInstalled: z.ZodObject<{
         source: string;
         ref: string;
         latest: string | null;
+        delivery: "package" | "descriptor";
         installed_at: string;
         update_available: boolean;
         incompatible_newer: string | null;
@@ -8657,6 +8407,7 @@ export declare const marketplaceInstalled: z.ZodObject<{
         source: string;
         ref: string;
         latest: string | null;
+        delivery: "package" | "descriptor";
         installed_at: string;
         update_available: boolean;
         incompatible_newer: string | null;
@@ -8681,6 +8432,7 @@ export declare const marketplaceInstalled: z.ZodObject<{
         source: string;
         ref: string;
         latest: string | null;
+        delivery: "package" | "descriptor";
         installed_at: string;
         update_available: boolean;
         incompatible_newer: string | null;
@@ -9028,6 +8780,11 @@ export type MarketplacePreviewPublicRoute = z.infer<typeof marketplacePreviewPub
  * 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`.
+ *
+ * `required_env` is every env var the spec requires with its derived secret-ness;
+ * `missing_env` is the bare names not already present in the env store union
+ * process env (server-computed — the ONE authority the dialog collects), and
+ * `delivery` is the one word the surface shows (`package` / `descriptor`).
  */
 export declare const marketplaceInstallPreview: z.ZodObject<{
     ref: z.ZodString;
@@ -9122,6 +8879,18 @@ export declare const marketplaceInstallPreview: z.ZodObject<{
         full_path: string;
     }>, "many">;
     requires_public_acceptance: z.ZodBoolean;
+    required_env: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        secret: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        secret: boolean;
+    }, {
+        name: string;
+        secret: boolean;
+    }>, "many">;
+    missing_env: z.ZodArray<z.ZodString, "many">;
+    delivery: z.ZodEnum<["package", "descriptor"]>;
 }, "strip", z.ZodTypeAny, {
     items: {
         kind: string;
@@ -9136,7 +8905,12 @@ export declare const marketplaceInstallPreview: z.ZodObject<{
         default_base: string;
     }[];
     version: string;
+    required_env: {
+        name: string;
+        secret: boolean;
+    }[];
     ref: string;
+    delivery: "package" | "descriptor";
     collisions: {
         methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
         item: string;
@@ -9155,6 +8929,7 @@ export declare const marketplaceInstallPreview: z.ZodObject<{
         full_path: string;
     }[];
     requires_public_acceptance: boolean;
+    missing_env: string[];
 }, {
     items: {
         kind: string;
@@ -9169,7 +8944,12 @@ export declare const marketplaceInstallPreview: z.ZodObject<{
         default_base: string;
     }[];
     version: string;
+    required_env: {
+        name: string;
+        secret: boolean;
+    }[];
     ref: string;
+    delivery: "package" | "descriptor";
     collisions: {
         methods: ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
         item: string;
@@ -9188,6 +8968,7 @@ export declare const marketplaceInstallPreview: z.ZodObject<{
         full_path: string;
     }[];
     requires_public_acceptance: boolean;
+    missing_env: string[];
 }>;
 export type MarketplaceInstallPreview = z.infer<typeof marketplaceInstallPreview>;
 /**