@vibesdotdev/config 0.0.1

package/dist/routing/types.d.ts

@@ -0,0 +1,358 @@
+/**
+ * Discriminated Routing Types
+ *
+ * Types for discriminated field routing - where a discriminator field value
+ * dynamically loads variant-specific fields, schemas, and component overrides.
+ */
+import type { ZodTypeAny } from 'zod/v4';
+import type { ConfigFieldMeta, ConfigFieldGroup } from '../manifest/types.ts';
+import type { FormStep } from '../crud/shared.ts';
+import type { LazyComponentOverride, ExtensionSurface } from '../extensions/types.ts';
+/**
+ * Surface-specific component overrides for a variant
+ */
+export interface VariantSurfaceOverrides {
+    /** TUI (React/OpenTUI) component overrides */
+    tui?: Record<string, LazyComponentOverride>;
+    /** Web (SvelteKit) component overrides */
+    web?: Record<string, LazyComponentOverride>;
+    /** CLI component overrides */
+    cli?: Record<string, LazyComponentOverride>;
+}
+/**
+ * A manifest variant that extends/overrides a base manifest
+ * based on a discriminator field value.
+ *
+ * @template TConfig - The configuration type for this variant
+ */
+export interface ManifestVariant<TConfig extends Record<string, unknown> = Record<string, unknown>> {
+    /** Unique variant identifier (matches discriminator value) */
+    id: string;
+    /**
+     * Schema extension (merged with base schema)
+     * Variant-specific validation that extends the base schema
+     */
+    schema?: ZodTypeAny;
+    /**
+     * Field extensions - merged with base manifest fields
+     * Variant fields are added/override base fields
+     */
+    fields: Record<string, ConfigFieldMeta>;
+    /**
+     * Field groups - merged with base manifest groups
+     */
+    groups?: ConfigFieldGroup[];
+    /**
+     * Default values for variant-specific fields
+     * Merged with base defaults (variant wins on conflict)
+     */
+    defaults?: Partial<TConfig>;
+    /**
+     * Optional: Override step field placement
+     * If not provided, fields auto-inject by matching group ID
+     * If provided, completely replaces base form steps
+     */
+    stepOverrides?: FormStep[];
+    /**
+     * Surface-specific component overrides
+     * Keyed by surface type, then by field key
+     */
+    overrides?: VariantSurfaceOverrides;
+}
+/**
+ * Variant loader function type
+ * Used for lazy loading variants on demand
+ */
+export type VariantLoader = () => Promise<Map<string, ManifestVariant>>;
+/**
+ * Routing configuration for a manifest
+ * Enables discriminated field routing based on a field value
+ */
+export interface ManifestRouting {
+    /**
+     * Field key that determines which variant to load
+     * e.g., 'providerType', 'agentType'
+     */
+    discriminator: string;
+    /**
+     * Display priority for discriminator field (lower = first)
+     * Controls where discriminator appears in forms
+     * @default 0 (appears first)
+     */
+    priority?: number;
+    /**
+     * Variants map or lazy loader function
+     * - Map: Eagerly loaded variants keyed by discriminator value
+     * - Function: Lazy loader that returns variants on demand
+     */
+    variants: Map<string, ManifestVariant> | VariantLoader;
+    /**
+     * Optional fallback variant when discriminator value doesn't match
+     */
+    fallback?: ManifestVariant;
+}
+/**
+ * Nested routing configuration for sub-objects with their own discriminators.
+ * Used when a manifest contains multiple discriminated unions (e.g., agent roles).
+ *
+ * @example
+ * ```typescript
+ * // For autoloop config with multiple agent roles:
+ * nestedRoutings: [
+ *   { path: 'agents.orchestration', discriminator: 'type', variants: agentVariants },
+ *   { path: 'agents.development', discriminator: 'type', variants: agentVariants },
+ *   { path: 'agents.planning', discriminator: 'type', variants: agentVariants },
+ * ]
+ * ```
+ */
+export interface NestedRouting {
+    /**
+     * Dot-notation path to the nested object containing the discriminator.
+     * e.g., 'agents.orchestration', 'providers.primary'
+     */
+    path: string;
+    /**
+     * Field key within the nested object that determines variant.
+     * e.g., 'type' (full path becomes 'agents.orchestration.type')
+     */
+    discriminator: string;
+    /**
+     * Display label for this nested routing section
+     */
+    label: string;
+    /**
+     * Optional description for the section
+     */
+    description?: string;
+    /**
+     * Optional icon for the section
+     */
+    icon?: string;
+    /**
+     * Field path for enable/disable toggle (relative to path).
+     * When set, the section shows an enable/disable toggle.
+     * e.g., 'enabled' (full path becomes 'agents.orchestration.enabled')
+     */
+    enableField?: string;
+    /**
+     * Whether this nested routing is required (no enable toggle).
+     * @default false
+     */
+    required?: boolean;
+    /**
+     * Display priority (lower = first in list)
+     * @default 100
+     */
+    priority?: number;
+    /**
+     * Variants map or lazy loader function.
+     * Can reference shared variants across multiple nested routings.
+     */
+    variants: Map<string, ManifestVariant> | VariantLoader;
+    /**
+     * Optional fallback variant when discriminator value doesn't match
+     */
+    fallback?: ManifestVariant;
+    /**
+     * Fields to show in collapsed summary view.
+     * Paths are relative to the nested object.
+     * e.g., ['model', 'provider'] shows agents.orchestration.model
+     */
+    summaryFields?: string[];
+    /**
+     * Whether the section starts expanded
+     * @default false
+     */
+    defaultExpanded?: boolean;
+}
+/**
+ * Active nested variant state for tracking multiple discriminators
+ */
+export interface ActiveNestedVariant {
+    /** The routing path this variant is active for */
+    path: string;
+    /** The discriminator value */
+    discriminatorValue: string;
+    /** The resolved variant */
+    variant: ManifestVariant;
+    /** Whether this section is enabled (if enableField is set) */
+    enabled: boolean;
+}
+/**
+ * Result of resolving a nested variant
+ */
+export interface ResolvedNestedVariant<TConfig extends Record<string, unknown> = Record<string, unknown>> {
+    /** The routing path */
+    path: string;
+    /** The resolved variant (or undefined if not found) */
+    variant?: ManifestVariant<TConfig>;
+    /** Whether the variant was found */
+    found: boolean;
+    /** The discriminator value used for lookup */
+    discriminatorValue: string;
+    /** Whether fallback was used */
+    usedFallback: boolean;
+    /** Whether this nested routing is enabled */
+    enabled: boolean;
+}
+/**
+ * Authentication type for provider connections
+ */
+export type ProviderAuthType = 'none' | 'bearer' | 'api_key' | 'basic' | 'oauth';
+/**
+ * Provider category for organization
+ */
+export type ProviderCategory = 'local' | 'cloud' | 'custom';
+/**
+ * Hardware constraint for provider execution
+ * - 'consumer': Runs on user's machine (CLI, local server)
+ * - 'cloud': Runs on platform servers
+ */
+export type HardwareConstraint = 'consumer' | 'cloud';
+/**
+ * Provider client interface - minimal contract for lazy-loaded clients
+ */
+export interface ProviderClient {
+    /** Provider identifier */
+    readonly providerId: string;
+    /** Test connection to the provider */
+    testConnection?(): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+/**
+ * Provider client factory type
+ */
+export type ProviderClientFactory = () => Promise<ProviderClient>;
+/**
+ * Provider metadata
+ */
+export interface ProviderMeta {
+    /** Display label */
+    label: string;
+    /** Icon (emoji) */
+    icon: string;
+    /** Short description */
+    description: string;
+    /** Provider category */
+    category: ProviderCategory;
+    /**
+     * Hardware constraints - where this provider can run
+     * Defaults to ['consumer', 'cloud'] if not specified
+     */
+    hardware?: HardwareConstraint[];
+    /** Supported capabilities */
+    capabilities?: string[];
+    /** Documentation URL */
+    docsUrl?: string;
+}
+/**
+ * Provider adapter configuration
+ */
+export interface ProviderAdapter {
+    /** Lazy-load client factory (optional - only needed if connection testing is implemented) */
+    client?: ProviderClientFactory;
+    /** Authentication type */
+    authType: ProviderAuthType;
+    /** Whether connection test is available */
+    supportsConnectionTest?: boolean;
+}
+/**
+ * Complete provider module definition
+ *
+ * A provider module is a complete provider definition that includes:
+ * - Identity and metadata
+ * - Adapter/client implementation
+ * - Operating defaults
+ * - Config manifest variant
+ *
+ * @template TConfig - The configuration type for this provider
+ */
+export interface ProviderModule<TConfig extends Record<string, unknown> = Record<string, unknown>> {
+    /** Unique provider identifier (e.g., 'local-llm', 'cloud-llm') */
+    id: string;
+    /** Provider type for discrimination (usually same as id) */
+    type: string;
+    /** Provider metadata */
+    meta: ProviderMeta;
+    /** Adapter configuration */
+    adapter: ProviderAdapter;
+    /** Operating defaults for this provider */
+    defaults: TConfig;
+    /** Config manifest variant */
+    config: ManifestVariant<TConfig>;
+}
+/**
+ * Result of variant resolution
+ */
+export interface ResolvedVariant<TConfig extends Record<string, unknown> = Record<string, unknown>> {
+    /** The resolved variant (or undefined if not found) */
+    variant?: ManifestVariant<TConfig>;
+    /** Whether the variant was found */
+    found: boolean;
+    /** The discriminator value used for lookup */
+    discriminatorValue: string;
+    /** Whether fallback was used */
+    usedFallback: boolean;
+}
+/**
+ * Options for getting surface overrides from a variant
+ */
+export interface GetVariantOverridesOptions {
+    /** The variant to get overrides from */
+    variant: ManifestVariant;
+    /** Target surface */
+    surface: ExtensionSurface;
+    /** Whether to include base manifest overrides */
+    includeBase?: boolean;
+}
+/**
+ * Type guard to check if routing has lazy variants
+ */
+export declare function hasLazyVariants(routing: ManifestRouting): routing is ManifestRouting & {
+    variants: VariantLoader;
+};
+/**
+ * Type guard to check if routing has eager variants
+ */
+export declare function hasEagerVariants(routing: ManifestRouting): routing is ManifestRouting & {
+    variants: Map<string, ManifestVariant>;
+};
+/**
+ * Type guard to check if an object is a ManifestVariant
+ */
+export declare function isManifestVariant(obj: unknown): obj is ManifestVariant;
+/**
+ * Type guard to check if an object is a ProviderModule
+ */
+export declare function isProviderModule(obj: unknown): obj is ProviderModule;
+/**
+ * Type guard to check if nested routing has lazy variants
+ */
+export declare function hasNestedLazyVariants(routing: NestedRouting): routing is NestedRouting & {
+    variants: VariantLoader;
+};
+/**
+ * Type guard to check if nested routing has eager variants
+ */
+export declare function hasNestedEagerVariants(routing: NestedRouting): routing is NestedRouting & {
+    variants: Map<string, ManifestVariant>;
+};
+/**
+ * Type guard to check if an object is a NestedRouting
+ */
+export declare function isNestedRouting(obj: unknown): obj is NestedRouting;
+/**
+ * Get the full discriminator path for a nested routing
+ * @param routing - The nested routing
+ * @returns Full dot-notation path (e.g., 'agents.orchestration.type')
+ */
+export declare function getNestedDiscriminatorPath(routing: NestedRouting): string;
+/**
+ * Get the full enable field path for a nested routing
+ * @param routing - The nested routing
+ * @returns Full dot-notation path or undefined if no enable field
+ */
+export declare function getNestedEnablePath(routing: NestedRouting): string | undefined;
+//# sourceMappingURL=types.d.ts.map

package/dist/routing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/routing/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAItF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC5C,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC5C,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAC/B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEjE,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IAEpB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAExC;;OAEG;IACH,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC;IAE3B;;;OAGG;IACH,SAAS,CAAC,EAAE,uBAAuB,CAAC;CACpC;AAID;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,aAAa,CAAC;IAEvD;;OAEG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC3B;AAID;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAC7B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,aAAa,CAAC;IAEvD;;OAEG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2BAA2B;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CACrC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEjE,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,OAAO,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACnC,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,8CAA8C;IAC9C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;CACjB;AAID;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAEjF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,OAAO,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,cAAc,CAAC,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAChC,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,6FAA6F;IAC7F,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,0BAA0B;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,2CAA2C;IAC3C,sBAAsB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChG,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IAEX,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IAEb,wBAAwB;IACxB,IAAI,EAAE,YAAY,CAAC;IAEnB,4BAA4B;IAC5B,OAAO,EAAE,eAAe,CAAC;IAEzB,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAElB,8BAA8B;IAC9B,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;CACjC;AAID;;GAEG;AACH,MAAM,WAAW,eAAe,CAC/B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEjE,uDAAuD;IACvD,OAAO,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACnC,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,8CAA8C;IAC9C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,YAAY,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,wCAAwC;IACxC,OAAO,EAAE,eAAe,CAAC;IACzB,qBAAqB;IACrB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAID;;GAEG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,eAAe,GACtB,OAAO,IAAI,eAAe,GAAG;IAAE,QAAQ,EAAE,aAAa,CAAA;CAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,eAAe,GACtB,OAAO,IAAI,eAAe,GAAG;IAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CAAE,CAEzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,eAAe,CAStE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CAYpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,aAAa,GACpB,OAAO,IAAI,aAAa,GAAG;IAAE,QAAQ,EAAE,aAAa,CAAA;CAAE,CAExD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,aAAa,GACpB,OAAO,IAAI,aAAa,GAAG;IAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CAAE,CAEvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAYlE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAG9E"}

package/dist/routing/types.js

@@ -0,0 +1,89 @@
+/**
+ * Discriminated Routing Types
+ *
+ * Types for discriminated field routing - where a discriminator field value
+ * dynamically loads variant-specific fields, schemas, and component overrides.
+ */
+// Type Guards
+/**
+ * Type guard to check if routing has lazy variants
+ */
+export function hasLazyVariants(routing) {
+    return typeof routing.variants === 'function';
+}
+/**
+ * Type guard to check if routing has eager variants
+ */
+export function hasEagerVariants(routing) {
+    return routing.variants instanceof Map;
+}
+/**
+ * Type guard to check if an object is a ManifestVariant
+ */
+export function isManifestVariant(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'id' in obj &&
+        'fields' in obj &&
+        typeof obj.id === 'string' &&
+        typeof obj.fields === 'object');
+}
+/**
+ * Type guard to check if an object is a ProviderModule
+ */
+export function isProviderModule(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'id' in obj &&
+        'type' in obj &&
+        'meta' in obj &&
+        'adapter' in obj &&
+        'defaults' in obj &&
+        'config' in obj &&
+        isManifestVariant(obj.config));
+}
+/**
+ * Type guard to check if nested routing has lazy variants
+ */
+export function hasNestedLazyVariants(routing) {
+    return typeof routing.variants === 'function';
+}
+/**
+ * Type guard to check if nested routing has eager variants
+ */
+export function hasNestedEagerVariants(routing) {
+    return routing.variants instanceof Map;
+}
+/**
+ * Type guard to check if an object is a NestedRouting
+ */
+export function isNestedRouting(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'path' in obj &&
+        'discriminator' in obj &&
+        'label' in obj &&
+        'variants' in obj &&
+        typeof obj.path === 'string' &&
+        typeof obj.discriminator === 'string' &&
+        typeof obj.label === 'string');
+}
+/**
+ * Get the full discriminator path for a nested routing
+ * @param routing - The nested routing
+ * @returns Full dot-notation path (e.g., 'agents.orchestration.type')
+ */
+export function getNestedDiscriminatorPath(routing) {
+    return `${routing.path}.${routing.discriminator}`;
+}
+/**
+ * Get the full enable field path for a nested routing
+ * @param routing - The nested routing
+ * @returns Full dot-notation path or undefined if no enable field
+ */
+export function getNestedEnablePath(routing) {
+    if (!routing.enableField)
+        return undefined;
+    return `${routing.path}.${routing.enableField}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/routing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/routing/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyWH,cAAc;AAEd;;GAEG;AACH,MAAM,UAAU,eAAe,CAC9B,OAAwB;IAExB,OAAO,OAAO,OAAO,CAAC,QAAQ,KAAK,UAAU,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC/B,OAAwB;IAExB,OAAO,OAAO,CAAC,QAAQ,YAAY,GAAG,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC7C,OAAO,CACN,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,IAAI,IAAI,GAAG;QACX,QAAQ,IAAI,GAAG;QACf,OAAQ,GAAuB,CAAC,EAAE,KAAK,QAAQ;QAC/C,OAAQ,GAAuB,CAAC,MAAM,KAAK,QAAQ,CACnD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC5C,OAAO,CACN,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,IAAI,IAAI,GAAG;QACX,MAAM,IAAI,GAAG;QACb,MAAM,IAAI,GAAG;QACb,SAAS,IAAI,GAAG;QAChB,UAAU,IAAI,GAAG;QACjB,QAAQ,IAAI,GAAG;QACf,iBAAiB,CAAE,GAAsB,CAAC,MAAM,CAAC,CACjD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACpC,OAAsB;IAEtB,OAAO,OAAO,OAAO,CAAC,QAAQ,KAAK,UAAU,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACrC,OAAsB;IAEtB,OAAO,OAAO,CAAC,QAAQ,YAAY,GAAG,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC3C,OAAO,CACN,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,MAAM,IAAI,GAAG;QACb,eAAe,IAAI,GAAG;QACtB,OAAO,IAAI,GAAG;QACd,UAAU,IAAI,GAAG;QACjB,OAAQ,GAAqB,CAAC,IAAI,KAAK,QAAQ;QAC/C,OAAQ,GAAqB,CAAC,aAAa,KAAK,QAAQ;QACxD,OAAQ,GAAqB,CAAC,KAAK,KAAK,QAAQ,CAChD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAsB;IAChE,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACzD,IAAI,CAAC,OAAO,CAAC,WAAW;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;AACjD,CAAC"}

package/dist/schema/extend-zod.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Zod Schema Extensions for Config Fields
+ *
+ * Provides a fluent builder pattern to attach reference and UI metadata
+ * to Zod schemas. This enables schema-driven form generation with
+ * dynamic option resolution.
+ *
+ * @example
+ * ```typescript
+ * const schema = z.object({
+ *   widgetId: configField(z.string())
+ *     .references('example.widgets', { labelField: 'name' })
+ *     .label('Widget')
+ *     .emptyState({ message: 'No widgets configured' })
+ *     .build()
+ * });
+ * ```
+ */
+import type { ZodTypeAny } from 'zod/v4';
+import type { ReferenceMeta, ConfigReference, NestedReference, ComputedReference, EnumReference, EmptyStateConfig } from './references.ts';
+import type { UIMeta, ConfigFieldMeta } from './schemas/extend-zod.schema.ts';
+export type { UIMeta, ConfigFieldMeta } from './schemas/extend-zod.schema.ts';
+/**
+ * Fluent builder for config-aware schemas
+ */
+export declare class ConfigFieldBuilder<T extends ZodTypeAny> {
+    private _schema;
+    private _referenceMeta?;
+    private _uiMeta;
+    constructor(schema: T);
+    /**
+     * Reference another config collection
+     * @example .references('example.things')
+     * @example .references('example.widgets', { labelField: 'name', filter: 'isActive' })
+     */
+    references(path: string, options?: Omit<ConfigReference, 'type' | 'path'>): this;
+    /**
+     * Reference nested data within a parent config item
+     * @example .referencesNested('example.widgets', 'widgetId', 'parts')
+     */
+    referencesNested(parentPath: string, parentField: string, nestedPath: string, options?: Omit<NestedReference, 'type' | 'parentPath' | 'parentField' | 'nestedPath'>): this;
+    /**
+     * Resolve options via async function
+     * @example .computed('fetchWidgetParts', { dependsOn: ['widgetId'] })
+     */
+    computed(resolver: string, options?: Omit<ComputedReference, 'type' | 'resolver'>): this;
+    /**
+     * Static enum options
+     * @example .options([{ value: 'a', label: 'Option A' }])
+     */
+    options(values: EnumReference['values']): this;
+    /**
+     * UI rendering style
+     */
+    as(style: NonNullable<ReferenceMeta['as']>): this;
+    /**
+     * Allow multiple selection
+     */
+    multiple(allow?: boolean): this;
+    /**
+     * Configure empty state
+     */
+    emptyState(config: EmptyStateConfig): this;
+    /**
+     * Set UI label
+     */
+    label(text: string): this;
+    /**
+     * Set UI description (shown as subtitle)
+     */
+    description(text: string): this;
+    /**
+     * Set help text (shown as tooltip or hint)
+     */
+    helpText(text: string): this;
+    /**
+     * Set placeholder text
+     */
+    placeholder(text: string): this;
+    /**
+     * Set field order (lower = earlier)
+     */
+    order(n: number): this;
+    /**
+     * Set field group for sectioning
+     */
+    group(id: string): this;
+    /**
+     * Hide field from UI
+     */
+    hidden(hide?: boolean): this;
+    /**
+     * Mark field as read-only
+     */
+    readOnly(ro?: boolean): this;
+    /**
+     * Set component type hint
+     */
+    component(type: NonNullable<UIMeta['component']>): this;
+    /**
+     * Build the final schema with metadata attached
+     */
+    build(): T;
+}
+/**
+ * Create a config-aware field builder
+ *
+ * @example
+ * ```typescript
+ * const widgetId = configField(z.string())
+ *   .references('example.widgets')
+ *   .label('Widget')
+ *   .build();
+ * ```
+ */
+export declare function configField<T extends ZodTypeAny>(schema: T): ConfigFieldBuilder<T>;
+/**
+ * Extract reference metadata from schema
+ */
+export declare function getReferenceMeta(schema: ZodTypeAny): ReferenceMeta | undefined;
+/**
+ * Extract UI metadata from schema
+ */
+export declare function getUIMeta(schema: ZodTypeAny): UIMeta | undefined;
+/**
+ * Extract all config field metadata from schema
+ */
+export declare function getConfigFieldMeta(schema: ZodTypeAny): ConfigFieldMeta;
+/**
+ * Check if schema has reference metadata
+ */
+export declare function hasReference(schema: ZodTypeAny): boolean;
+/**
+ * Check if schema has any config field metadata
+ */
+export declare function hasConfigFieldMeta(schema: ZodTypeAny): boolean;
+//# sourceMappingURL=extend-zod.d.ts.map

package/dist/schema/extend-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend-zod.d.ts","sourceRoot":"","sources":["../../src/schema/extend-zod.ts"],"names":[],"mappings":"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"}