@kya-os/cli 2.0.0 → 2.0.3

package/node_modules/@kya-os/contracts/dist/consent/schemas.d.ts

@@ -0,0 +1,965 @@
+/**
+ * Consent Schemas
+ *
+ * Zod schemas for runtime validation of consent-related data structures.
+ * All types are derived from these schemas using z.infer.
+ *
+ * Related Spec: MCP-I Phase 0 Implementation Plan
+ */
+import { z } from "zod";
+/**
+ * Consent Branding Schema
+ */
+export declare const consentBrandingSchema: z.ZodObject<{
+    primaryColor: z.ZodOptional<z.ZodString>;
+    logoUrl: z.ZodOptional<z.ZodString>;
+    companyName: z.ZodOptional<z.ZodString>;
+    theme: z.ZodOptional<z.ZodEnum<["light", "dark", "auto"]>>;
+}, "strip", z.ZodTypeAny, {
+    primaryColor?: string | undefined;
+    logoUrl?: string | undefined;
+    companyName?: string | undefined;
+    theme?: "light" | "dark" | "auto" | undefined;
+}, {
+    primaryColor?: string | undefined;
+    logoUrl?: string | undefined;
+    companyName?: string | undefined;
+    theme?: "light" | "dark" | "auto" | undefined;
+}>;
+export type ConsentBranding = z.infer<typeof consentBrandingSchema>;
+/**
+ * Consent Terms Schema
+ */
+export declare const consentTermsSchema: z.ZodObject<{
+    text: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    required: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    required: boolean;
+    text?: string | undefined;
+    version?: string | undefined;
+    url?: string | undefined;
+}, {
+    text?: string | undefined;
+    required?: boolean | undefined;
+    version?: string | undefined;
+    url?: string | undefined;
+}>;
+export type ConsentTerms = z.infer<typeof consentTermsSchema>;
+/**
+ * Consent Custom Field Option Schema
+ */
+export declare const consentCustomFieldOptionSchema: z.ZodObject<{
+    value: z.ZodString;
+    label: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    label: string;
+}, {
+    value: string;
+    label: string;
+}>;
+/**
+ * Consent Custom Field Schema
+ */
+export declare const consentCustomFieldSchema: z.ZodEffects<z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodEnum<["text", "textarea", "checkbox", "select", "email"]>;
+    required: z.ZodBoolean;
+    placeholder: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+    }, {
+        value: string;
+        label: string;
+    }>, "many">>;
+    pattern: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "text" | "email" | "textarea" | "checkbox" | "select";
+    name: string;
+    required: boolean;
+    label: string;
+    options?: {
+        value: string;
+        label: string;
+    }[] | undefined;
+    placeholder?: string | undefined;
+    pattern?: string | undefined;
+}, {
+    type: "text" | "email" | "textarea" | "checkbox" | "select";
+    name: string;
+    required: boolean;
+    label: string;
+    options?: {
+        value: string;
+        label: string;
+    }[] | undefined;
+    placeholder?: string | undefined;
+    pattern?: string | undefined;
+}>, {
+    type: "text" | "email" | "textarea" | "checkbox" | "select";
+    name: string;
+    required: boolean;
+    label: string;
+    options?: {
+        value: string;
+        label: string;
+    }[] | undefined;
+    placeholder?: string | undefined;
+    pattern?: string | undefined;
+}, {
+    type: "text" | "email" | "textarea" | "checkbox" | "select";
+    name: string;
+    required: boolean;
+    label: string;
+    options?: {
+        value: string;
+        label: string;
+    }[] | undefined;
+    placeholder?: string | undefined;
+    pattern?: string | undefined;
+}>;
+export type ConsentCustomField = z.infer<typeof consentCustomFieldSchema>;
+/**
+ * OAuth Identity Schema
+ *
+ * Represents a user's OAuth provider account information.
+ * Used in Phase 4 to link OAuth accounts to persistent User DIDs.
+ */
+export declare const oauthIdentitySchema: z.ZodObject<{
+    /**
+     * OAuth provider name (e.g., "google", "github", "microsoft")
+     */
+    provider: z.ZodString;
+    /**
+     * OAuth subject identifier (unique user ID from provider)
+     * @example "123456789" (Google), "github-user-id" (GitHub)
+     */
+    subject: z.ZodString;
+    /**
+     * User's email address from OAuth provider (optional)
+     */
+    email: z.ZodOptional<z.ZodString>;
+    /**
+     * User's display name from OAuth provider (optional)
+     */
+    name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    provider: string;
+    subject: string;
+    name?: string | undefined;
+    email?: string | undefined;
+}, {
+    provider: string;
+    subject: string;
+    name?: string | undefined;
+    email?: string | undefined;
+}>;
+export type OAuthIdentity = z.infer<typeof oauthIdentitySchema>;
+/**
+ * Consent Page Config Schema
+ */
+export declare const consentPageConfigSchema: z.ZodEffects<z.ZodObject<{
+    tool: z.ZodString;
+    toolDescription: z.ZodString;
+    scopes: z.ZodArray<z.ZodString, "many">;
+    agentDid: z.ZodString;
+    sessionId: z.ZodString;
+    projectId: z.ZodString;
+    provider: z.ZodOptional<z.ZodString>;
+    branding: z.ZodOptional<z.ZodObject<{
+        primaryColor: z.ZodOptional<z.ZodString>;
+        logoUrl: z.ZodOptional<z.ZodString>;
+        companyName: z.ZodOptional<z.ZodString>;
+        theme: z.ZodOptional<z.ZodEnum<["light", "dark", "auto"]>>;
+    }, "strip", z.ZodTypeAny, {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    }, {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    }>>;
+    terms: z.ZodOptional<z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        required: boolean;
+        text?: string | undefined;
+        version?: string | undefined;
+        url?: string | undefined;
+    }, {
+        text?: string | undefined;
+        required?: boolean | undefined;
+        version?: string | undefined;
+        url?: string | undefined;
+    }>>;
+    customFields: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<["text", "textarea", "checkbox", "select", "email"]>;
+        required: z.ZodBoolean;
+        placeholder: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            label: string;
+        }, {
+            value: string;
+            label: string;
+        }>, "many">>;
+        pattern: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }, {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }>, {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }, {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }>, "many">>;
+    serverUrl: z.ZodString;
+    autoClose: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Whether OAuth authorization is required immediately
+     * If true, the consent page will act as a landing page before redirecting
+     */
+    oauthRequired: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * The OAuth authorization URL to redirect to
+     * Required if oauthRequired is true
+     */
+    oauthUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>>;
+}, "strip", z.ZodTypeAny, {
+    agentDid: string;
+    projectId: string;
+    scopes: string[];
+    sessionId: string;
+    tool: string;
+    toolDescription: string;
+    serverUrl: string;
+    branding?: {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    } | undefined;
+    provider?: string | undefined;
+    terms?: {
+        required: boolean;
+        text?: string | undefined;
+        version?: string | undefined;
+        url?: string | undefined;
+    } | undefined;
+    customFields?: {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }[] | undefined;
+    autoClose?: boolean | undefined;
+    oauthRequired?: boolean | undefined;
+    oauthUrl?: string | undefined;
+}, {
+    agentDid: string;
+    projectId: string;
+    scopes: string[];
+    sessionId: string;
+    tool: string;
+    toolDescription: string;
+    serverUrl: string;
+    branding?: {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    } | undefined;
+    provider?: string | undefined;
+    terms?: {
+        text?: string | undefined;
+        required?: boolean | undefined;
+        version?: string | undefined;
+        url?: string | undefined;
+    } | undefined;
+    customFields?: {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }[] | undefined;
+    autoClose?: boolean | undefined;
+    oauthRequired?: boolean | undefined;
+    oauthUrl?: string | undefined;
+}>, {
+    agentDid: string;
+    projectId: string;
+    scopes: string[];
+    sessionId: string;
+    tool: string;
+    toolDescription: string;
+    serverUrl: string;
+    branding?: {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    } | undefined;
+    provider?: string | undefined;
+    terms?: {
+        required: boolean;
+        text?: string | undefined;
+        version?: string | undefined;
+        url?: string | undefined;
+    } | undefined;
+    customFields?: {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }[] | undefined;
+    autoClose?: boolean | undefined;
+    oauthRequired?: boolean | undefined;
+    oauthUrl?: string | undefined;
+}, {
+    agentDid: string;
+    projectId: string;
+    scopes: string[];
+    sessionId: string;
+    tool: string;
+    toolDescription: string;
+    serverUrl: string;
+    branding?: {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    } | undefined;
+    provider?: string | undefined;
+    terms?: {
+        text?: string | undefined;
+        required?: boolean | undefined;
+        version?: string | undefined;
+        url?: string | undefined;
+    } | undefined;
+    customFields?: {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }[] | undefined;
+    autoClose?: boolean | undefined;
+    oauthRequired?: boolean | undefined;
+    oauthUrl?: string | undefined;
+}>;
+export type ConsentPageConfig = z.infer<typeof consentPageConfigSchema>;
+/**
+ * Consent Approval Request Schema
+ *
+ * Note: Uses snake_case for API compatibility (agent_did, session_id, project_id)
+ *
+ * Phase 4 additions:
+ * - oauth_identity: Optional OAuth provider information for identity linking
+ * - user_did: Optional User DID for persistent identity (if already known)
+ */
+export declare const consentApprovalRequestSchema: z.ZodObject<{
+    tool: z.ZodString;
+    scopes: z.ZodArray<z.ZodString, "many">;
+    agent_did: z.ZodString;
+    session_id: z.ZodString;
+    project_id: z.ZodString;
+    termsAccepted: z.ZodBoolean;
+    termsVersion: z.ZodOptional<z.ZodString>;
+    customFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodBoolean]>>>;
+    /**
+     * OAuth provider identity information (optional)
+     * Used to link OAuth accounts to persistent User DIDs
+     *
+     * CRITICAL: Uses .nullish() to accept null, undefined, or OAuthIdentity
+     * This matches JSON parsing behavior where missing fields become null
+     */
+    oauth_identity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        /**
+         * OAuth provider name (e.g., "google", "github", "microsoft")
+         */
+        provider: z.ZodString;
+        /**
+         * OAuth subject identifier (unique user ID from provider)
+         * @example "123456789" (Google), "github-user-id" (GitHub)
+         */
+        subject: z.ZodString;
+        /**
+         * User's email address from OAuth provider (optional)
+         */
+        email: z.ZodOptional<z.ZodString>;
+        /**
+         * User's display name from OAuth provider (optional)
+         */
+        name: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        provider: string;
+        subject: string;
+        name?: string | undefined;
+        email?: string | undefined;
+    }, {
+        provider: string;
+        subject: string;
+        name?: string | undefined;
+        email?: string | undefined;
+    }>>>;
+    /**
+     * User DID (optional)
+     * If provided, represents the persistent User DID for this user
+     * Format: did:key:... or did:web:...
+     */
+    user_did: z.ZodOptional<z.ZodString>;
+    /**
+     * Human-readable user identifier from credential authentication (email/username).
+     * Used for display in AgentShield dashboard.
+     * This comes from the credential provider response (e.g., customer.email from Hardware World).
+     * Maps to: user_identifier in delegation metadata
+     */
+    credential_user_email: z.ZodOptional<z.ZodString>;
+    /**
+     * Provider's internal user ID from credential authentication.
+     * This is the provider-specific identifier (e.g., customer ID 696395 from Hardware World).
+     * Used for business reference and linking to provider systems.
+     * Maps to: user_id in delegation metadata
+     */
+    credential_provider_user_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scopes: string[];
+    tool: string;
+    session_id: string;
+    agent_did: string;
+    project_id: string;
+    termsAccepted: boolean;
+    user_did?: string | undefined;
+    customFields?: Record<string, string | boolean> | undefined;
+    termsVersion?: string | undefined;
+    oauth_identity?: {
+        provider: string;
+        subject: string;
+        name?: string | undefined;
+        email?: string | undefined;
+    } | null | undefined;
+    credential_user_email?: string | undefined;
+    credential_provider_user_id?: string | undefined;
+}, {
+    scopes: string[];
+    tool: string;
+    session_id: string;
+    agent_did: string;
+    project_id: string;
+    termsAccepted: boolean;
+    user_did?: string | undefined;
+    customFields?: Record<string, string | boolean> | undefined;
+    termsVersion?: string | undefined;
+    oauth_identity?: {
+        provider: string;
+        subject: string;
+        name?: string | undefined;
+        email?: string | undefined;
+    } | null | undefined;
+    credential_user_email?: string | undefined;
+    credential_provider_user_id?: string | undefined;
+}>;
+export type ConsentApprovalRequest = z.infer<typeof consentApprovalRequestSchema>;
+/**
+ * Consent Approval Response Schema
+ */
+export declare const consentApprovalResponseSchema: z.ZodEffects<z.ZodObject<{
+    success: z.ZodBoolean;
+    delegation_id: z.ZodOptional<z.ZodString>;
+    delegation_token: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    error_code: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    error?: string | undefined;
+    delegation_id?: string | undefined;
+    delegation_token?: string | undefined;
+    error_code?: string | undefined;
+}, {
+    success: boolean;
+    error?: string | undefined;
+    delegation_id?: string | undefined;
+    delegation_token?: string | undefined;
+    error_code?: string | undefined;
+}>, {
+    success: boolean;
+    error?: string | undefined;
+    delegation_id?: string | undefined;
+    delegation_token?: string | undefined;
+    error_code?: string | undefined;
+}, {
+    success: boolean;
+    error?: string | undefined;
+    delegation_id?: string | undefined;
+    delegation_token?: string | undefined;
+    error_code?: string | undefined;
+}>;
+export type ConsentApprovalResponse = z.infer<typeof consentApprovalResponseSchema>;
+/**
+ * Consent Config Schema
+ */
+export declare const consentConfigSchema: z.ZodObject<{
+    branding: z.ZodOptional<z.ZodObject<{
+        primaryColor: z.ZodOptional<z.ZodString>;
+        logoUrl: z.ZodOptional<z.ZodString>;
+        companyName: z.ZodOptional<z.ZodString>;
+        theme: z.ZodOptional<z.ZodEnum<["light", "dark", "auto"]>>;
+    }, "strip", z.ZodTypeAny, {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    }, {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    }>>;
+    terms: z.ZodOptional<z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        required: boolean;
+        text?: string | undefined;
+        version?: string | undefined;
+        url?: string | undefined;
+    }, {
+        text?: string | undefined;
+        required?: boolean | undefined;
+        version?: string | undefined;
+        url?: string | undefined;
+    }>>;
+    customFields: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<["text", "textarea", "checkbox", "select", "email"]>;
+        required: z.ZodBoolean;
+        placeholder: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            label: string;
+        }, {
+            value: string;
+            label: string;
+        }>, "many">>;
+        pattern: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }, {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }>, {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }, {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }>, "many">>;
+    ui: z.ZodOptional<z.ZodObject<{
+        theme: z.ZodOptional<z.ZodEnum<["light", "dark", "auto"]>>;
+        popupEnabled: z.ZodOptional<z.ZodBoolean>;
+        autoClose: z.ZodOptional<z.ZodBoolean>;
+        autoCloseDelay: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        theme?: "light" | "dark" | "auto" | undefined;
+        autoClose?: boolean | undefined;
+        popupEnabled?: boolean | undefined;
+        autoCloseDelay?: number | undefined;
+    }, {
+        theme?: "light" | "dark" | "auto" | undefined;
+        autoClose?: boolean | undefined;
+        popupEnabled?: boolean | undefined;
+        autoCloseDelay?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    branding?: {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    } | undefined;
+    terms?: {
+        required: boolean;
+        text?: string | undefined;
+        version?: string | undefined;
+        url?: string | undefined;
+    } | undefined;
+    customFields?: {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }[] | undefined;
+    ui?: {
+        theme?: "light" | "dark" | "auto" | undefined;
+        autoClose?: boolean | undefined;
+        popupEnabled?: boolean | undefined;
+        autoCloseDelay?: number | undefined;
+    } | undefined;
+}, {
+    branding?: {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    } | undefined;
+    terms?: {
+        text?: string | undefined;
+        required?: boolean | undefined;
+        version?: string | undefined;
+        url?: string | undefined;
+    } | undefined;
+    customFields?: {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }[] | undefined;
+    ui?: {
+        theme?: "light" | "dark" | "auto" | undefined;
+        autoClose?: boolean | undefined;
+        popupEnabled?: boolean | undefined;
+        autoCloseDelay?: number | undefined;
+    } | undefined;
+}>;
+export type ConsentConfig = z.infer<typeof consentConfigSchema>;
+/**
+ * Validation Helpers
+ */
+/**
+ * Validate a consent page config
+ *
+ * @param config - The config to validate
+ * @returns Validation result
+ */
+export declare function validateConsentPageConfig(config: unknown): z.SafeParseReturnType<{
+    agentDid: string;
+    projectId: string;
+    scopes: string[];
+    sessionId: string;
+    tool: string;
+    toolDescription: string;
+    serverUrl: string;
+    branding?: {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    } | undefined;
+    provider?: string | undefined;
+    terms?: {
+        text?: string | undefined;
+        required?: boolean | undefined;
+        version?: string | undefined;
+        url?: string | undefined;
+    } | undefined;
+    customFields?: {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }[] | undefined;
+    autoClose?: boolean | undefined;
+    oauthRequired?: boolean | undefined;
+    oauthUrl?: string | undefined;
+}, {
+    agentDid: string;
+    projectId: string;
+    scopes: string[];
+    sessionId: string;
+    tool: string;
+    toolDescription: string;
+    serverUrl: string;
+    branding?: {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    } | undefined;
+    provider?: string | undefined;
+    terms?: {
+        required: boolean;
+        text?: string | undefined;
+        version?: string | undefined;
+        url?: string | undefined;
+    } | undefined;
+    customFields?: {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }[] | undefined;
+    autoClose?: boolean | undefined;
+    oauthRequired?: boolean | undefined;
+    oauthUrl?: string | undefined;
+}>;
+/**
+ * Validate a consent approval request
+ *
+ * @param request - The request to validate
+ * @returns Validation result
+ */
+export declare function validateConsentApprovalRequest(request: unknown): z.SafeParseReturnType<{
+    scopes: string[];
+    tool: string;
+    session_id: string;
+    agent_did: string;
+    project_id: string;
+    termsAccepted: boolean;
+    user_did?: string | undefined;
+    customFields?: Record<string, string | boolean> | undefined;
+    termsVersion?: string | undefined;
+    oauth_identity?: {
+        provider: string;
+        subject: string;
+        name?: string | undefined;
+        email?: string | undefined;
+    } | null | undefined;
+    credential_user_email?: string | undefined;
+    credential_provider_user_id?: string | undefined;
+}, {
+    scopes: string[];
+    tool: string;
+    session_id: string;
+    agent_did: string;
+    project_id: string;
+    termsAccepted: boolean;
+    user_did?: string | undefined;
+    customFields?: Record<string, string | boolean> | undefined;
+    termsVersion?: string | undefined;
+    oauth_identity?: {
+        provider: string;
+        subject: string;
+        name?: string | undefined;
+        email?: string | undefined;
+    } | null | undefined;
+    credential_user_email?: string | undefined;
+    credential_provider_user_id?: string | undefined;
+}>;
+/**
+ * Validate a consent approval response
+ *
+ * @param response - The response to validate
+ * @returns Validation result
+ */
+export declare function validateConsentApprovalResponse(response: unknown): z.SafeParseReturnType<{
+    success: boolean;
+    error?: string | undefined;
+    delegation_id?: string | undefined;
+    delegation_token?: string | undefined;
+    error_code?: string | undefined;
+}, {
+    success: boolean;
+    error?: string | undefined;
+    delegation_id?: string | undefined;
+    delegation_token?: string | undefined;
+    error_code?: string | undefined;
+}>;
+/**
+ * Validate a consent config
+ *
+ * @param config - The config to validate
+ * @returns Validation result
+ */
+export declare function validateConsentConfig(config: unknown): z.SafeParseReturnType<{
+    branding?: {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    } | undefined;
+    terms?: {
+        text?: string | undefined;
+        required?: boolean | undefined;
+        version?: string | undefined;
+        url?: string | undefined;
+    } | undefined;
+    customFields?: {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }[] | undefined;
+    ui?: {
+        theme?: "light" | "dark" | "auto" | undefined;
+        autoClose?: boolean | undefined;
+        popupEnabled?: boolean | undefined;
+        autoCloseDelay?: number | undefined;
+    } | undefined;
+}, {
+    branding?: {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    } | undefined;
+    terms?: {
+        required: boolean;
+        text?: string | undefined;
+        version?: string | undefined;
+        url?: string | undefined;
+    } | undefined;
+    customFields?: {
+        type: "text" | "email" | "textarea" | "checkbox" | "select";
+        name: string;
+        required: boolean;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }[] | undefined;
+    ui?: {
+        theme?: "light" | "dark" | "auto" | undefined;
+        autoClose?: boolean | undefined;
+        popupEnabled?: boolean | undefined;
+        autoCloseDelay?: number | undefined;
+    } | undefined;
+}>;