@skaile/workspaces 0.8.5

package/dist/types/src/manifests/preset.d.ts

@@ -0,0 +1,704 @@
+/**
+ * Polymorphic Preset manifest schema.
+ *
+ * A Preset is the unified composition + configuration primitive. Items can be:
+ * - Asset ref (plain or with inline config + placeholders)
+ * - Library Instance ref (`library://tier/instances/id`)
+ * - Nested Preset ref (resolved recursively, max depth 3)
+ *
+ * Apply semantics derive from ref type, not an explicit mode field.
+ */
+import * as z from "zod";
+import { type ManifestValidationResult } from "./_shared.js";
+export declare const PlaceholderTypeValues: readonly ["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"];
+export declare const PlaceholderTypeSchema: z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>;
+export declare const PlaceholderSchema: z.ZodObject<{
+    key: z.ZodString;
+    prompt: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    values?: (string | number)[] | undefined;
+    prompt?: string | undefined;
+    type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+    default?: string | number | boolean | undefined;
+    required?: boolean | undefined;
+}, {
+    key: string;
+    values?: (string | number)[] | undefined;
+    prompt?: string | undefined;
+    type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+    default?: string | number | boolean | undefined;
+    required?: boolean | undefined;
+}>;
+export declare const PresetItemSchema: z.ZodObject<{
+    /** Asset ref, Library Instance ref, or nested Preset ref. */
+    ref: z.ZodString;
+    /** Local item ID for cross-item references (#item-id). */
+    id: z.ZodOptional<z.ZodString>;
+    /** Author-prefilled non-secret config values. */
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** User/secret values prompted at install. */
+    placeholders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        prompt: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        values?: (string | number)[] | undefined;
+        prompt?: string | undefined;
+        type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+    }, {
+        key: string;
+        values?: (string | number)[] | undefined;
+        prompt?: string | undefined;
+        type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+    }>, "many">>;
+    /** How placeholder values fold into the Instance config. */
+    materialize: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** Composition for agent items. */
+    composes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        ref: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        ref: string;
+        kind: string;
+    }, {
+        ref: string;
+        kind: string;
+    }>, "many">>;
+    /** Outer-Preset-author-supplied placeholder values for nested Presets. */
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    /** Asset ref, Library Instance ref, or nested Preset ref. */
+    ref: z.ZodString;
+    /** Local item ID for cross-item references (#item-id). */
+    id: z.ZodOptional<z.ZodString>;
+    /** Author-prefilled non-secret config values. */
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** User/secret values prompted at install. */
+    placeholders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        prompt: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        values?: (string | number)[] | undefined;
+        prompt?: string | undefined;
+        type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+    }, {
+        key: string;
+        values?: (string | number)[] | undefined;
+        prompt?: string | undefined;
+        type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+    }>, "many">>;
+    /** How placeholder values fold into the Instance config. */
+    materialize: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** Composition for agent items. */
+    composes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        ref: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        ref: string;
+        kind: string;
+    }, {
+        ref: string;
+        kind: string;
+    }>, "many">>;
+    /** Outer-Preset-author-supplied placeholder values for nested Presets. */
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    /** Asset ref, Library Instance ref, or nested Preset ref. */
+    ref: z.ZodString;
+    /** Local item ID for cross-item references (#item-id). */
+    id: z.ZodOptional<z.ZodString>;
+    /** Author-prefilled non-secret config values. */
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** User/secret values prompted at install. */
+    placeholders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        prompt: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        values?: (string | number)[] | undefined;
+        prompt?: string | undefined;
+        type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+    }, {
+        key: string;
+        values?: (string | number)[] | undefined;
+        prompt?: string | undefined;
+        type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+    }>, "many">>;
+    /** How placeholder values fold into the Instance config. */
+    materialize: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** Composition for agent items. */
+    composes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        ref: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        ref: string;
+        kind: string;
+    }, {
+        ref: string;
+        kind: string;
+    }>, "many">>;
+    /** Outer-Preset-author-supplied placeholder values for nested Presets. */
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const PresetInputSchema: z.ZodObject<{
+    key: z.ZodString;
+    type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+    prompt: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+    default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    values?: (string | number)[] | undefined;
+    prompt?: string | undefined;
+    type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+    default?: string | number | boolean | undefined;
+    required?: boolean | undefined;
+}, {
+    key: string;
+    values?: (string | number)[] | undefined;
+    prompt?: string | undefined;
+    type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+    default?: string | number | boolean | undefined;
+    required?: boolean | undefined;
+}>;
+export declare const PresetManifestSchema: z.ZodObject<{
+    publisher: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    version: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    description: z.ZodString;
+    category: z.ZodOptional<z.ZodString>;
+    license: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** 1+ polymorphic items. */
+    items: z.ZodArray<z.ZodObject<{
+        /** Asset ref, Library Instance ref, or nested Preset ref. */
+        ref: z.ZodString;
+        /** Local item ID for cross-item references (#item-id). */
+        id: z.ZodOptional<z.ZodString>;
+        /** Author-prefilled non-secret config values. */
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /** User/secret values prompted at install. */
+        placeholders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            prompt: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }>, "many">>;
+        /** How placeholder values fold into the Instance config. */
+        materialize: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Composition for agent items. */
+        composes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            ref: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            ref: string;
+            kind: string;
+        }, {
+            ref: string;
+            kind: string;
+        }>, "many">>;
+        /** Outer-Preset-author-supplied placeholder values for nested Presets. */
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /** Asset ref, Library Instance ref, or nested Preset ref. */
+        ref: z.ZodString;
+        /** Local item ID for cross-item references (#item-id). */
+        id: z.ZodOptional<z.ZodString>;
+        /** Author-prefilled non-secret config values. */
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /** User/secret values prompted at install. */
+        placeholders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            prompt: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }>, "many">>;
+        /** How placeholder values fold into the Instance config. */
+        materialize: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Composition for agent items. */
+        composes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            ref: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            ref: string;
+            kind: string;
+        }, {
+            ref: string;
+            kind: string;
+        }>, "many">>;
+        /** Outer-Preset-author-supplied placeholder values for nested Presets. */
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /** Asset ref, Library Instance ref, or nested Preset ref. */
+        ref: z.ZodString;
+        /** Local item ID for cross-item references (#item-id). */
+        id: z.ZodOptional<z.ZodString>;
+        /** Author-prefilled non-secret config values. */
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /** User/secret values prompted at install. */
+        placeholders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            prompt: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }>, "many">>;
+        /** How placeholder values fold into the Instance config. */
+        materialize: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Composition for agent items. */
+        composes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            ref: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            ref: string;
+            kind: string;
+        }, {
+            ref: string;
+            kind: string;
+        }>, "many">>;
+        /** Outer-Preset-author-supplied placeholder values for nested Presets. */
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    /** Preset-level inputs shared across items (rare). */
+    inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+        prompt: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+        default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        values?: (string | number)[] | undefined;
+        prompt?: string | undefined;
+        type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+    }, {
+        key: string;
+        values?: (string | number)[] | undefined;
+        prompt?: string | undefined;
+        type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+    }>, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    publisher: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    version: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    description: z.ZodString;
+    category: z.ZodOptional<z.ZodString>;
+    license: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** 1+ polymorphic items. */
+    items: z.ZodArray<z.ZodObject<{
+        /** Asset ref, Library Instance ref, or nested Preset ref. */
+        ref: z.ZodString;
+        /** Local item ID for cross-item references (#item-id). */
+        id: z.ZodOptional<z.ZodString>;
+        /** Author-prefilled non-secret config values. */
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /** User/secret values prompted at install. */
+        placeholders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            prompt: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }>, "many">>;
+        /** How placeholder values fold into the Instance config. */
+        materialize: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Composition for agent items. */
+        composes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            ref: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            ref: string;
+            kind: string;
+        }, {
+            ref: string;
+            kind: string;
+        }>, "many">>;
+        /** Outer-Preset-author-supplied placeholder values for nested Presets. */
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /** Asset ref, Library Instance ref, or nested Preset ref. */
+        ref: z.ZodString;
+        /** Local item ID for cross-item references (#item-id). */
+        id: z.ZodOptional<z.ZodString>;
+        /** Author-prefilled non-secret config values. */
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /** User/secret values prompted at install. */
+        placeholders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            prompt: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }>, "many">>;
+        /** How placeholder values fold into the Instance config. */
+        materialize: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Composition for agent items. */
+        composes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            ref: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            ref: string;
+            kind: string;
+        }, {
+            ref: string;
+            kind: string;
+        }>, "many">>;
+        /** Outer-Preset-author-supplied placeholder values for nested Presets. */
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /** Asset ref, Library Instance ref, or nested Preset ref. */
+        ref: z.ZodString;
+        /** Local item ID for cross-item references (#item-id). */
+        id: z.ZodOptional<z.ZodString>;
+        /** Author-prefilled non-secret config values. */
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /** User/secret values prompted at install. */
+        placeholders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            prompt: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }>, "many">>;
+        /** How placeholder values fold into the Instance config. */
+        materialize: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Composition for agent items. */
+        composes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            ref: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            ref: string;
+            kind: string;
+        }, {
+            ref: string;
+            kind: string;
+        }>, "many">>;
+        /** Outer-Preset-author-supplied placeholder values for nested Presets. */
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    /** Preset-level inputs shared across items (rare). */
+    inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+        prompt: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+        default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        values?: (string | number)[] | undefined;
+        prompt?: string | undefined;
+        type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+    }, {
+        key: string;
+        values?: (string | number)[] | undefined;
+        prompt?: string | undefined;
+        type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+    }>, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    publisher: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    version: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    description: z.ZodString;
+    category: z.ZodOptional<z.ZodString>;
+    license: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** 1+ polymorphic items. */
+    items: z.ZodArray<z.ZodObject<{
+        /** Asset ref, Library Instance ref, or nested Preset ref. */
+        ref: z.ZodString;
+        /** Local item ID for cross-item references (#item-id). */
+        id: z.ZodOptional<z.ZodString>;
+        /** Author-prefilled non-secret config values. */
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /** User/secret values prompted at install. */
+        placeholders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            prompt: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }>, "many">>;
+        /** How placeholder values fold into the Instance config. */
+        materialize: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Composition for agent items. */
+        composes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            ref: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            ref: string;
+            kind: string;
+        }, {
+            ref: string;
+            kind: string;
+        }>, "many">>;
+        /** Outer-Preset-author-supplied placeholder values for nested Presets. */
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /** Asset ref, Library Instance ref, or nested Preset ref. */
+        ref: z.ZodString;
+        /** Local item ID for cross-item references (#item-id). */
+        id: z.ZodOptional<z.ZodString>;
+        /** Author-prefilled non-secret config values. */
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /** User/secret values prompted at install. */
+        placeholders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            prompt: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }>, "many">>;
+        /** How placeholder values fold into the Instance config. */
+        materialize: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Composition for agent items. */
+        composes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            ref: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            ref: string;
+            kind: string;
+        }, {
+            ref: string;
+            kind: string;
+        }>, "many">>;
+        /** Outer-Preset-author-supplied placeholder values for nested Presets. */
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /** Asset ref, Library Instance ref, or nested Preset ref. */
+        ref: z.ZodString;
+        /** Local item ID for cross-item references (#item-id). */
+        id: z.ZodOptional<z.ZodString>;
+        /** Author-prefilled non-secret config values. */
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /** User/secret values prompted at install. */
+        placeholders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            prompt: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }, {
+            key: string;
+            values?: (string | number)[] | undefined;
+            prompt?: string | undefined;
+            type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+            default?: string | number | boolean | undefined;
+            required?: boolean | undefined;
+        }>, "many">>;
+        /** How placeholder values fold into the Instance config. */
+        materialize: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Composition for agent items. */
+        composes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            ref: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            ref: string;
+            kind: string;
+        }, {
+            ref: string;
+            kind: string;
+        }>, "many">>;
+        /** Outer-Preset-author-supplied placeholder values for nested Presets. */
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    /** Preset-level inputs shared across items (rare). */
+    inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<["text", "multiline", "secret", "number", "boolean", "enum", "oauth", "instance-picker"]>>;
+        prompt: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        values: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+        default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        values?: (string | number)[] | undefined;
+        prompt?: string | undefined;
+        type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+    }, {
+        key: string;
+        values?: (string | number)[] | undefined;
+        prompt?: string | undefined;
+        type?: "number" | "boolean" | "text" | "multiline" | "secret" | "enum" | "oauth" | "instance-picker" | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+    }>, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+export type PresetManifest = z.infer<typeof PresetManifestSchema>;
+export type PresetItem = z.infer<typeof PresetItemSchema>;
+export type Placeholder = z.infer<typeof PlaceholderSchema>;
+export declare function validatePreset(data: unknown): ManifestValidationResult<PresetManifest>;
+//# sourceMappingURL=preset.d.ts.map