@tai42/api-client 4.0.0 → 6.0.0

package/dist/schemas.d.ts

@@ -4034,6 +4034,109 @@ export declare const interactionAnswered: z.ZodObject<{
     interaction_id: string;
 }>;
 export type InteractionAnswered = z.infer<typeof interactionAnswered>;
+/**
+ * A page of pending interactions from `GET /api/interactions?page=&pageSize=`. Each
+ * item is the same record the stream's `interaction.add` frame carries. The pending
+ * set is the paged base the tail-only stream applies live deltas over.
+ */
+export declare const interactionsPage: 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<{
+        interaction_id: z.ZodString;
+        group_id: z.ZodString;
+        question: z.ZodDefault<z.ZodString>;
+        answer_format: z.ZodEnum<["text", "confirm", "select", "form", "external"]>;
+        format_payload: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>, Record<string, unknown>, Record<string, unknown> | null | undefined>;
+        created_at: z.ZodString;
+        timeout_at: z.ZodString;
+        sensitive: z.ZodDefault<z.ZodBoolean>;
+        server_verified: z.ZodOptional<z.ZodBoolean>;
+        channel: z.ZodOptional<z.ZodString>;
+        recipient: z.ZodOptional<z.ZodString>;
+        origin: z.ZodOptional<z.ZodString>;
+        audience: z.ZodOptional<z.ZodString>;
+        media: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        created_at: string;
+        interaction_id: string;
+        group_id: string;
+        question: string;
+        answer_format: "text" | "confirm" | "select" | "form" | "external";
+        format_payload: Record<string, unknown>;
+        timeout_at: string;
+        sensitive: boolean;
+        origin?: string | undefined;
+        server_verified?: boolean | undefined;
+        channel?: string | undefined;
+        recipient?: string | undefined;
+        audience?: string | undefined;
+        media?: unknown[] | undefined;
+    }, {
+        created_at: string;
+        interaction_id: string;
+        group_id: string;
+        answer_format: "text" | "confirm" | "select" | "form" | "external";
+        timeout_at: string;
+        origin?: string | undefined;
+        question?: string | undefined;
+        format_payload?: Record<string, unknown> | null | undefined;
+        sensitive?: boolean | undefined;
+        server_verified?: boolean | undefined;
+        channel?: string | undefined;
+        recipient?: string | undefined;
+        audience?: string | undefined;
+        media?: unknown[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        created_at: string;
+        interaction_id: string;
+        group_id: string;
+        question: string;
+        answer_format: "text" | "confirm" | "select" | "form" | "external";
+        format_payload: Record<string, unknown>;
+        timeout_at: string;
+        sensitive: boolean;
+        origin?: string | undefined;
+        server_verified?: boolean | undefined;
+        channel?: string | undefined;
+        recipient?: string | undefined;
+        audience?: string | undefined;
+        media?: unknown[] | undefined;
+    }[];
+    total: number;
+    page: number;
+    page_size: number;
+    next_page: number | null;
+    truncated: boolean;
+}, {
+    items: {
+        created_at: string;
+        interaction_id: string;
+        group_id: string;
+        answer_format: "text" | "confirm" | "select" | "form" | "external";
+        timeout_at: string;
+        origin?: string | undefined;
+        question?: string | undefined;
+        format_payload?: Record<string, unknown> | null | undefined;
+        sensitive?: boolean | undefined;
+        server_verified?: boolean | undefined;
+        channel?: string | undefined;
+        recipient?: string | undefined;
+        audience?: string | undefined;
+        media?: unknown[] | undefined;
+    }[];
+    total: number;
+    page: number;
+    page_size: number;
+    next_page: number | null;
+    truncated: boolean;
+}>;
+export type InteractionsPage = z.infer<typeof interactionsPage>;
 export declare const channels: z.ZodObject<{
     channels: z.ZodArray<z.ZodString, "many">;
 }, "strip", z.ZodTypeAny, {
@@ -6876,13 +6979,10 @@ export declare const run: z.ZodObject<{
     cost: z.ZodNullable<z.ZodNumber>;
     latencyMs: z.ZodNullable<z.ZodNumber>;
     totalTokens: z.ZodNullable<z.ZodNumber>;
-    model: z.ZodNullable<z.ZodString>;
     inputPreview: z.ZodType<unknown, z.ZodTypeDef, unknown>;
     outputPreview: z.ZodType<unknown, z.ZodTypeDef, unknown>;
-    fetchError: z.ZodNullable<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     status: "error" | "success";
-    model: string | null;
     tags: string[];
     id: string;
     totalTokens: number | null;
@@ -6890,12 +6990,10 @@ export declare const run: z.ZodObject<{
     traceId: string;
     createdAt: string | null;
     latencyMs: number | null;
-    fetchError: string | null;
     inputPreview?: unknown;
     outputPreview?: unknown;
 }, {
     status: "error" | "success";
-    model: string | null;
     tags: string[];
     id: string;
     totalTokens: number | null;
@@ -6903,7 +7001,6 @@ export declare const run: z.ZodObject<{
     traceId: string;
     createdAt: string | null;
     latencyMs: number | null;
-    fetchError: string | null;
     inputPreview?: unknown;
     outputPreview?: unknown;
 }>;
@@ -6918,13 +7015,10 @@ export declare const runsPage: z.ZodObject<{
         cost: z.ZodNullable<z.ZodNumber>;
         latencyMs: z.ZodNullable<z.ZodNumber>;
         totalTokens: z.ZodNullable<z.ZodNumber>;
-        model: z.ZodNullable<z.ZodString>;
         inputPreview: z.ZodType<unknown, z.ZodTypeDef, unknown>;
         outputPreview: z.ZodType<unknown, z.ZodTypeDef, unknown>;
-        fetchError: z.ZodNullable<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         status: "error" | "success";
-        model: string | null;
         tags: string[];
         id: string;
         totalTokens: number | null;
@@ -6932,12 +7026,10 @@ export declare const runsPage: z.ZodObject<{
         traceId: string;
         createdAt: string | null;
         latencyMs: number | null;
-        fetchError: string | null;
         inputPreview?: unknown;
         outputPreview?: unknown;
     }, {
         status: "error" | "success";
-        model: string | null;
         tags: string[];
         id: string;
         totalTokens: number | null;
@@ -6945,7 +7037,6 @@ export declare const runsPage: z.ZodObject<{
         traceId: string;
         createdAt: string | null;
         latencyMs: number | null;
-        fetchError: string | null;
         inputPreview?: unknown;
         outputPreview?: unknown;
     }>, "many">;
@@ -6954,7 +7045,6 @@ export declare const runsPage: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     items: {
         status: "error" | "success";
-        model: string | null;
         tags: string[];
         id: string;
         totalTokens: number | null;
@@ -6962,7 +7052,6 @@ export declare const runsPage: z.ZodObject<{
         traceId: string;
         createdAt: string | null;
         latencyMs: number | null;
-        fetchError: string | null;
         inputPreview?: unknown;
         outputPreview?: unknown;
     }[];
@@ -6971,7 +7060,6 @@ export declare const runsPage: z.ZodObject<{
 }, {
     items: {
         status: "error" | "success";
-        model: string | null;
         tags: string[];
         id: string;
         totalTokens: number | null;
@@ -6979,7 +7067,6 @@ export declare const runsPage: z.ZodObject<{
         traceId: string;
         createdAt: string | null;
         latencyMs: number | null;
-        fetchError: string | null;
         inputPreview?: unknown;
         outputPreview?: unknown;
     }[];
@@ -7044,8 +7131,6 @@ export declare const runTrace: z.ZodObject<{
     input: z.ZodType<unknown, z.ZodTypeDef, unknown>;
     output: z.ZodType<unknown, z.ZodTypeDef, unknown>;
     metadata: z.ZodNullable<z.ZodType<unknown, z.ZodTypeDef, unknown>>;
-    availability: z.ZodEnum<["unavailable", "full", "partial"]>;
-    fetchError: z.ZodNullable<z.ZodString>;
     spans: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         parentId: z.ZodNullable<z.ZodString>;
@@ -7099,9 +7184,7 @@ export declare const runTrace: z.ZodObject<{
     tags: string[];
     totalCost: number | null;
     traceId: string;
-    fetchError: string | null;
     timestamp: string | null;
-    availability: "partial" | "unavailable" | "full";
     spans: {
         name: string | null;
         type: string | null;
@@ -7126,9 +7209,7 @@ export declare const runTrace: z.ZodObject<{
     tags: string[];
     totalCost: number | null;
     traceId: string;
-    fetchError: string | null;
     timestamp: string | null;
-    availability: "partial" | "unavailable" | "full";
     spans: {
         name: string | null;
         type: string | null;
@@ -7159,6 +7240,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 +7331,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 +7374,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 +7398,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 +7416,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 +7472,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 +7517,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 +7542,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 +7568,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 +7613,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 +7638,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 +7671,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 +7701,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 +7741,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 +7791,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 +7815,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 +7833,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 +7854,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 +7878,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 +7925,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 +7981,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 +8005,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 +8023,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 +8044,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 +8068,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 +8106,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 +8131,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 +8156,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 +8181,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 +8228,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 +8280,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 +8307,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 +8326,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 +8359,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 +8411,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 +8438,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 +8457,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 +8488,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 +8513,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 +8861,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 +8960,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 +8986,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 +9010,7 @@ export declare const marketplaceInstallPreview: z.ZodObject<{
         full_path: string;
     }[];
     requires_public_acceptance: boolean;
+    missing_env: string[];
 }, {
     items: {
         kind: string;
@@ -9169,7 +9025,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 +9049,7 @@ export declare const marketplaceInstallPreview: z.ZodObject<{
         full_path: string;
     }[];
     requires_public_acceptance: boolean;
+    missing_env: string[];
 }>;
 export type MarketplaceInstallPreview = z.infer<typeof marketplaceInstallPreview>;
 /**