@elizaos/agent 0.25.8 → 2.0.0-alpha.144

package/packages/typescript/src/features/advanced-capabilities/form/types.d.ts

@@ -0,0 +1,588 @@
+/**
+ * @module types
+ * @description Core type definitions for the Form Plugin
+ *
+ * ## The Core Insight
+ *
+ * Forms are **guardrails for agent-guided user journeys**.
+ *
+ * Without structure, agents wander. They forget what they're collecting,
+ * miss required information, and can't reliably guide users to outcomes.
+ * These types define the rails that keep agents on track.
+ *
+ * - **FormDefinition** = The journey map (what stops are required)
+ * - **FormControl** = A stop on the journey (what info to collect)
+ * - **FormSession** = Progress through the journey (where we are)
+ * - **FormSubmission** = Journey complete (the outcome)
+ *
+ * ## Design Principles
+ *
+ * 1. **Agent-Native**: Designed for conversational, asynchronous interactions.
+ *    No form UI - the agent extracts data and guides the conversation.
+ *
+ * 2. **Future-Compatible**: Many fields are optional with sensible defaults.
+ *    The `meta` field on most interfaces allows arbitrary extension.
+ *
+ * 3. **Scoped Sessions**: Sessions are keyed by (entityId + roomId) because
+ *    a user might be on different journeys in different rooms.
+ *
+ * 4. **Effort-Aware**: Form data is retained based on user effort invested.
+ *    Someone who spent 2 hours deserves longer retention than 2 minutes.
+ *
+ * 5. **TypeScript-First**: Types use discriminated unions, generics, and
+ *    template literals for excellent IDE support and type safety.
+ */
+import type { IAgentRuntime, JsonValue, UUID } from "../../../types/index.ts";
+/**
+ * Select/choice option for select-type fields.
+ */
+export interface FormControlOption {
+    value: string;
+    label: string;
+    description?: string;
+}
+/**
+ * File upload configuration.
+ */
+export interface FormControlFileOptions {
+    /** MIME type patterns, e.g., ['image/*', 'application/pdf'] */
+    accept?: string[];
+    /** Maximum file size in bytes */
+    maxSize?: number;
+    /** Maximum number of files (for multiple uploads) */
+    maxFiles?: number;
+}
+/**
+ * Conditional field dependency.
+ */
+export interface FormControlDependency {
+    /** Key of the field this one depends on */
+    field: string;
+    /** When should this field be shown/asked */
+    condition: "exists" | "equals" | "not_equals";
+    /** Value to compare against for equals/not_equals */
+    value?: JsonValue;
+}
+/**
+ * UI hints for future frontends.
+ */
+export interface FormControlUI {
+    /** Section name for grouping fields */
+    section?: string;
+    /** Display order within section */
+    order?: number;
+    /** Placeholder text for input fields */
+    placeholder?: string;
+    /** Help text shown below input */
+    helpText?: string;
+    /** Custom widget type identifier */
+    widget?: string;
+}
+/**
+ * Localization for a field.
+ */
+export interface FormControlI18n {
+    label?: string;
+    description?: string;
+    askPrompt?: string;
+    helpText?: string;
+}
+/**
+ * FormControl - The central field abstraction
+ */
+export interface FormControl {
+    /** Unique key within the form. Used in values object. */
+    key: string;
+    /** Human-readable label. Shown to user if not using askPrompt. */
+    label: string;
+    /**
+     * Field type. Built-in types: 'text', 'number', 'email', 'boolean', 'select', 'date', 'file'.
+     * Custom types can be registered via FormService.registerType().
+     */
+    type: string;
+    /** If true, form cannot be submitted without this field. Default: false */
+    required?: boolean;
+    /** If true, accepts array of values. Default: false */
+    multiple?: boolean;
+    /** If true, value cannot be changed after initial set. Default: false */
+    readonly?: boolean;
+    /** If true, extract silently but never ask directly. Default: false */
+    hidden?: boolean;
+    /** If true, agent should not echo value back (passwords, tokens). Default: false */
+    sensitive?: boolean;
+    dbbind?: string;
+    /** Regex pattern for validation. Applied to string representation. */
+    pattern?: string;
+    /** Minimum value (for numbers) or minimum length (for strings) */
+    min?: number;
+    /** Maximum value (for numbers) or maximum length (for strings) */
+    max?: number;
+    /** Minimum string length (explicit, for when min is used for value) */
+    minLength?: number;
+    /** Maximum string length (explicit, for when max is used for value) */
+    maxLength?: number;
+    /** Allowed values (for string enums without select options) */
+    enum?: string[];
+    /** Options for 'select' type fields */
+    options?: FormControlOption[];
+    /** Configuration for 'file' type fields */
+    file?: FormControlFileOptions;
+    /** Default value if user doesn't provide one */
+    defaultValue?: JsonValue;
+    /** Conditional display/requirement based on another field */
+    dependsOn?: FormControlDependency;
+    roles?: string[];
+    description?: string;
+    askPrompt?: string;
+    extractHints?: string[];
+    confirmThreshold?: number;
+    /** Example value for "give me an example" request */
+    example?: string;
+    /** Hints for future GUI rendering */
+    ui?: FormControlUI;
+    /** Localized versions of label, description, askPrompt */
+    i18n?: Record<string, FormControlI18n>;
+    fields?: FormControl[];
+    meta?: Record<string, JsonValue>;
+}
+export interface FormDefinitionUX {
+    /** Allow "undo" to revert last change. Default: true */
+    allowUndo?: boolean;
+    /** Allow "skip" for optional fields. Default: true */
+    allowSkip?: boolean;
+    /** Maximum undo history size. Default: 5 */
+    maxUndoSteps?: number;
+    /** Show examples when user asks. Default: true */
+    showExamples?: boolean;
+    /** Show explanations when user asks. Default: true */
+    showExplanations?: boolean;
+    /** Allow autofill from previous submissions. Default: true */
+    allowAutofill?: boolean;
+}
+export interface FormDefinitionTTL {
+    /** Minimum retention in days, even with no effort. Default: 14 */
+    minDays?: number;
+    /** Maximum retention in days, regardless of effort. Default: 90 */
+    maxDays?: number;
+    /** Days added per minute of user effort. Default: 0.5. */
+    effortMultiplier?: number;
+}
+export interface FormDefinitionNudge {
+    /** Enable nudge messages. Default: true */
+    enabled?: boolean;
+    /** Hours of inactivity before first nudge. Default: 48 */
+    afterInactiveHours?: number;
+    /** Maximum nudge messages to send. Default: 3 */
+    maxNudges?: number;
+    /** Custom nudge message template */
+    message?: string;
+}
+export interface FormDefinitionHooks {
+    /** Called when session starts */
+    onStart?: string;
+    /** Called when any field changes */
+    onFieldChange?: string;
+    /** Called when all required fields are filled */
+    onReady?: string;
+    /** Called on successful submission */
+    onSubmit?: string;
+    /** Called when user cancels */
+    onCancel?: string;
+    /** Called when session expires */
+    onExpire?: string;
+}
+export interface FormDefinitionI18n {
+    name?: string;
+    description?: string;
+}
+export interface FormDefinition {
+    /** Unique identifier for this form definition */
+    id: string;
+    /** Human-readable name shown in UI and agent responses */
+    name: string;
+    /** Description of what this form collects */
+    description?: string;
+    /** Schema version for migrations. Default: 1. */
+    version?: number;
+    /** Array of field definitions */
+    controls: FormControl[];
+    status?: "draft" | "active" | "deprecated";
+    roles?: string[];
+    allowMultiple?: boolean;
+    ux?: FormDefinitionUX;
+    ttl?: FormDefinitionTTL;
+    nudge?: FormDefinitionNudge;
+    hooks?: FormDefinitionHooks;
+    debug?: boolean;
+    i18n?: Record<string, FormDefinitionI18n>;
+    meta?: Record<string, JsonValue>;
+}
+export interface FieldFile {
+    /** Unique identifier for the file */
+    id: string;
+    /** Original filename */
+    name: string;
+    /** MIME type */
+    mimeType: string;
+    /** Size in bytes */
+    size: number;
+    /** URL to access the file */
+    url: string;
+}
+export interface FieldState {
+    status: "empty" | "filled" | "uncertain" | "invalid" | "skipped" | "pending";
+    /** The current value (undefined if empty/skipped) */
+    value?: JsonValue;
+    confidence?: number;
+    /** Other possible interpretations of user message */
+    alternatives?: JsonValue[];
+    /** Validation error message if status is 'invalid' */
+    error?: string;
+    /** File metadata for file-type fields */
+    files?: FieldFile[];
+    source?: "extraction" | "autofill" | "default" | "manual" | "correction" | "external";
+    /** ID of message that provided this value */
+    messageId?: string;
+    /** When the value was last updated */
+    updatedAt?: number;
+    /** When user confirmed an uncertain value */
+    confirmedAt?: number;
+    subFields?: Record<string, FieldState>;
+    externalState?: {
+        /** Current status of the external interaction */
+        status: "pending" | "confirmed" | "failed" | "expired";
+        /** Reference used to match external events */
+        reference?: string;
+        /** Instructions shown to user (cached from activation) */
+        instructions?: string;
+        /** Address shown to user (cached from activation) */
+        address?: string;
+        /** When the external process was activated */
+        activatedAt?: number;
+        /** When the external process was confirmed */
+        confirmedAt?: number;
+        /** Data from the external confirmation (txId, signature, etc.) */
+        externalData?: Record<string, JsonValue>;
+    };
+    meta?: Record<string, JsonValue>;
+}
+export interface FieldHistoryEntry {
+    /** Which field was changed */
+    field: string;
+    /** Previous value (to restore) */
+    oldValue: JsonValue;
+    /** New value (for audit) */
+    newValue: JsonValue;
+    /** When the change happened */
+    timestamp: number;
+}
+export interface SessionEffort {
+    /** Number of messages processed for this form */
+    interactionCount: number;
+    /** Total time from first to last interaction */
+    timeSpentMs: number;
+    /** When user first interacted with this form */
+    firstInteractionAt: number;
+    /** When user last interacted with this form */
+    lastInteractionAt: number;
+}
+export interface FormSession {
+    /** Unique session ID */
+    id: string;
+    /** Reference to FormDefinition.id */
+    formId: string;
+    /** Form version at session start (for migration handling) */
+    formVersion?: number;
+    /** The user filling the form */
+    entityId: UUID;
+    /** The room where conversation is happening */
+    roomId: UUID;
+    status: "active" | "ready" | "submitted" | "stashed" | "cancelled" | "expired";
+    /** Current state of each field, keyed by control.key */
+    fields: Record<string, FieldState>;
+    /** Recent changes for undo functionality */
+    history: FieldHistoryEntry[];
+    parentSessionId?: string;
+    context?: Record<string, JsonValue>;
+    /** User's locale for i18n */
+    locale?: string;
+    /** Last field agent asked about (for skip functionality) */
+    lastAskedField?: string;
+    /** Last message processed (for deduplication) */
+    lastMessageId?: string;
+    /** True if we asked "are you sure you want to cancel?" */
+    cancelConfirmationAsked?: boolean;
+    effort: SessionEffort;
+    /** When this session expires (timestamp) */
+    expiresAt: number;
+    /** True if we already warned about expiration */
+    expirationWarned?: boolean;
+    /** Number of nudge messages sent */
+    nudgeCount?: number;
+    /** When we last sent a nudge */
+    lastNudgeAt?: number;
+    /** When session was created */
+    createdAt: number;
+    /** When session was last modified */
+    updatedAt: number;
+    /** When session was submitted (if status is 'submitted') */
+    submittedAt?: number;
+    meta?: Record<string, JsonValue>;
+}
+export interface FormSubmission {
+    /** Unique submission ID */
+    id: string;
+    /** Which form definition this is for */
+    formId: string;
+    /** Form version at submission time */
+    formVersion?: number;
+    /** The session that produced this submission */
+    sessionId: string;
+    /** Who submitted */
+    entityId: UUID;
+    /** Field values keyed by control.key */
+    values: Record<string, JsonValue>;
+    /** Same values but keyed by dbbind. */
+    mappedValues?: Record<string, JsonValue>;
+    /** File attachments keyed by control.key */
+    files?: Record<string, FieldFile[]>;
+    /** When the form was submitted */
+    submittedAt: number;
+    meta?: Record<string, JsonValue>;
+}
+/**
+ * TypeHandler - Custom type behavior (Legacy interface)
+ *
+ * @deprecated Use ControlType instead for new code.
+ */
+export interface TypeHandler {
+    /** Validate a value. Return { valid: true } or { valid: false, error: '...' } */
+    validate?: (value: JsonValue, control: FormControl) => {
+        valid: boolean;
+        error?: string;
+    };
+    /** Parse string input to appropriate type */
+    parse?: (value: string) => JsonValue;
+    /** Format value for display */
+    format?: (value: JsonValue) => string;
+    /** Description for LLM extraction. */
+    extractionPrompt?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+}
+export interface ActivationContext {
+    /** Runtime for accessing services */
+    runtime: IAgentRuntime;
+    /** The current form session */
+    session: FormSession;
+    /** The control being activated */
+    control: FormControl;
+    /** Filled subcontrol values, keyed by subcontrol key */
+    subValues: Record<string, JsonValue>;
+}
+export interface ExternalActivation {
+    /** Human-readable instructions for the user */
+    instructions: string;
+    /** Unique reference to match external events (e.g., memo, tx reference) */
+    reference: string;
+    /** Optional address (payment address, signing endpoint, etc.) */
+    address?: string;
+    /** When this activation expires (timestamp) */
+    expiresAt?: number;
+    /** Arbitrary metadata from the widget */
+    meta?: Record<string, JsonValue>;
+}
+export interface ExternalFieldState {
+    /** Current status of the external interaction */
+    status: "pending" | "confirmed" | "failed" | "expired";
+    /** Reference used to match external events */
+    reference?: string;
+    /** Instructions shown to user (cached from activation) */
+    instructions?: string;
+    /** Address shown to user (cached from activation) */
+    address?: string;
+    /** When the external process was activated */
+    activatedAt?: number;
+    /** When the external process was confirmed */
+    confirmedAt?: number;
+    /** Data from the external confirmation (txId, signature, etc.) */
+    externalData?: Record<string, JsonValue>;
+}
+export interface ControlType {
+    /** Unique identifier for this control type */
+    id: string;
+    /** If true, this is a built-in type that should warn on override. */
+    builtin?: boolean;
+    validate?: (value: JsonValue, control: FormControl) => ValidationResult;
+    parse?: (value: string) => JsonValue;
+    format?: (value: JsonValue) => string;
+    extractionPrompt?: string;
+    getSubControls?: (control: FormControl, runtime: IAgentRuntime) => FormControl[];
+    activate?: (context: ActivationContext) => Promise<ExternalActivation>;
+    deactivate?: (context: ActivationContext) => Promise<void>;
+}
+export type FormWidgetEventType = "FORM_FIELD_EXTRACTED" | "FORM_SUBFIELD_UPDATED" | "FORM_SUBCONTROLS_FILLED" | "FORM_EXTERNAL_ACTIVATED" | "FORM_FIELD_CONFIRMED" | "FORM_FIELD_CANCELLED";
+export interface FormFieldExtractedEvent {
+    type: "FORM_FIELD_EXTRACTED";
+    sessionId: string;
+    field: string;
+    value: JsonValue;
+    confidence: number;
+}
+export interface FormSubfieldUpdatedEvent {
+    type: "FORM_SUBFIELD_UPDATED";
+    sessionId: string;
+    parentField: string;
+    subField: string;
+    value: JsonValue;
+    confidence: number;
+}
+export interface FormSubcontrolsFilledEvent {
+    type: "FORM_SUBCONTROLS_FILLED";
+    sessionId: string;
+    field: string;
+    subValues: Record<string, JsonValue>;
+}
+export interface FormExternalActivatedEvent {
+    type: "FORM_EXTERNAL_ACTIVATED";
+    sessionId: string;
+    field: string;
+    activation: ExternalActivation;
+}
+export interface FormFieldConfirmedEvent {
+    type: "FORM_FIELD_CONFIRMED";
+    sessionId: string;
+    field: string;
+    value: JsonValue;
+    externalData?: Record<string, JsonValue>;
+}
+export interface FormFieldCancelledEvent {
+    type: "FORM_FIELD_CANCELLED";
+    sessionId: string;
+    field: string;
+    reason: string;
+}
+export type FormWidgetEvent = FormFieldExtractedEvent | FormSubfieldUpdatedEvent | FormSubcontrolsFilledEvent | FormExternalActivatedEvent | FormFieldConfirmedEvent | FormFieldCancelledEvent;
+export interface FilledFieldSummary {
+    key: string;
+    label: string;
+    /** Formatted value safe to show user (respects sensitive flag) */
+    displayValue: string;
+}
+export interface MissingFieldSummary {
+    key: string;
+    label: string;
+    description?: string;
+    /** How agent should ask for this field */
+    askPrompt?: string;
+}
+export interface UncertainFieldSummary {
+    key: string;
+    label: string;
+    /** The uncertain value */
+    value: JsonValue;
+    /** How confident the LLM was */
+    confidence: number;
+}
+export interface PendingExternalFieldSummary {
+    /** Field key */
+    key: string;
+    /** Field label for display */
+    label: string;
+    /** Instructions for the user */
+    instructions: string;
+    /** Reference for matching */
+    reference: string;
+    /** When the external process was activated */
+    activatedAt: number;
+    /** Optional address (payment address, etc.) */
+    address?: string;
+}
+export interface FormContextState {
+    /** True if there's an active form in this room */
+    hasActiveForm: boolean;
+    /** Current form ID */
+    formId?: string;
+    /** Current form name */
+    formName?: string;
+    /** Completion percentage (0-100) */
+    progress: number;
+    /** Fields that have been filled */
+    filledFields: FilledFieldSummary[];
+    /** Required fields still needed */
+    missingRequired: MissingFieldSummary[];
+    /** Fields needing user confirmation */
+    uncertainFields: UncertainFieldSummary[];
+    /** Next field to ask about */
+    nextField: FormControl | null;
+    /** Current session status */
+    status?: FormSession["status"];
+    /** Number of stashed forms */
+    stashedCount?: number;
+    /** True if we asked "are you sure you want to cancel?" */
+    pendingCancelConfirmation?: boolean;
+    /** External fields waiting for confirmation. */
+    pendingExternalFields: PendingExternalFieldSummary[];
+}
+export type FormIntent = "fill_form" | "submit" | "stash" | "restore" | "cancel" | "undo" | "skip" | "explain" | "example" | "progress" | "autofill" | "other";
+export interface ExtractionResult {
+    /** Which field this is for */
+    field: string;
+    /** Extracted value */
+    value: JsonValue;
+    /** LLM confidence (0-1) */
+    confidence: number;
+    /** LLM reasoning (for debug mode) */
+    reasoning?: string;
+    /** Other possible values if uncertain */
+    alternatives?: JsonValue[];
+    /** True if user is correcting previous value */
+    isCorrection?: boolean;
+}
+export interface IntentResult {
+    /** What the user wants to do */
+    intent: FormIntent;
+    /** Extracted field values (for fill_form intent) */
+    extractions: ExtractionResult[];
+    /** Target form ID for restore if multiple stashed */
+    targetFormId?: string;
+}
+export declare const FORM_CONTROL_DEFAULTS: {
+    readonly type: "text";
+    readonly required: false;
+    readonly confirmThreshold: 0.8;
+};
+export declare const FORM_DEFINITION_DEFAULTS: {
+    readonly version: 1;
+    readonly status: "active";
+    readonly ux: {
+        readonly allowUndo: true;
+        readonly allowSkip: true;
+        readonly maxUndoSteps: 5;
+        readonly showExamples: true;
+        readonly showExplanations: true;
+        readonly allowAutofill: true;
+    };
+    readonly ttl: {
+        readonly minDays: 14;
+        readonly maxDays: 90;
+        readonly effortMultiplier: 0.5;
+    };
+    readonly nudge: {
+        readonly enabled: true;
+        readonly afterInactiveHours: 48;
+        readonly maxNudges: 3;
+    };
+    readonly debug: false;
+};
+export declare const FORM_SESSION_COMPONENT = "form_session";
+export declare const FORM_SUBMISSION_COMPONENT = "form_submission";
+export declare const FORM_AUTOFILL_COMPONENT = "form_autofill";
+export interface FormAutofillData {
+    formId: string;
+    values: Record<string, JsonValue>;
+    updatedAt: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/typescript/src/features/advanced-capabilities/form/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/form/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAM9E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC9C,qDAAqD;IACrD,KAAK,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAE3B,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAGb,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oFAAoF;IACpF,SAAS,CAAC,EAAE,OAAO,CAAC;IAGpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAGhB,uCAAuC;IACvC,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAG9B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAG9B,gDAAgD;IAChD,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAGlC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAGjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,qCAAqC;IACrC,EAAE,CAAC,EAAE,aAAa,CAAC;IAGnB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAGvC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IAGvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACjC;AAMD,MAAM,WAAW,gBAAgB;IAChC,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8DAA8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IACjC,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IACnC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IACnC,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAE9B,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,iCAAiC;IACjC,QAAQ,EAAE,WAAW,EAAE,CAAC;IAGxB,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,YAAY,CAAC;IAG3C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAGjB,aAAa,CAAC,EAAE,OAAO,CAAC;IAGxB,EAAE,CAAC,EAAE,gBAAgB,CAAC;IAGtB,GAAG,CAAC,EAAE,iBAAiB,CAAC;IAGxB,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAG5B,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAG5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAGhB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAG1C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACjC;AAMD,MAAM,WAAW,SAAS;IACzB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IAE1B,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAG7E,qDAAqD;IACrD,KAAK,CAAC,EAAE,SAAS,CAAC;IAGlB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IAG3B,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,yCAAyC;IACzC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IAGpB,MAAM,CAAC,EACJ,YAAY,GACZ,UAAU,GACV,SAAS,GACT,QAAQ,GACR,YAAY,GACZ,UAAU,CAAC;IACd,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAGvC,aAAa,CAAC,EAAE;QACf,iDAAiD;QACjD,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;QACvD,8CAA8C;QAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,0DAA0D;QAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,qDAAqD;QACrD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,8CAA8C;QAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,8CAA8C;QAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kEAAkE;QAClE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;KACzC,CAAC;IAGF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACjC;AAMD,MAAM,WAAW,iBAAiB;IACjC,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,EAAE,SAAS,CAAC;IACpB,4BAA4B;IAC5B,QAAQ,EAAE,SAAS,CAAC;IACpB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC7B,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAE3B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,gCAAgC;IAChC,QAAQ,EAAE,IAAI,CAAC;IACf,+CAA+C;IAC/C,MAAM,EAAE,IAAI,CAAC;IAGb,MAAM,EACH,QAAQ,GACR,OAAO,GACP,WAAW,GACX,SAAS,GACT,WAAW,GACX,SAAS,CAAC;IAGb,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAGnC,4CAA4C;IAC5C,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAG7B,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAGlC,MAAM,EAAE,aAAa,CAAC;IAGtB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACjC;AAMD,MAAM,WAAW,cAAc;IAC9B,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,QAAQ,EAAE,IAAI,CAAC;IAEf,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAEpC,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IAEpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACjC;AAMD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,CACV,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,KAChB;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IACrC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,MAAM,CAAC;IACtC,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IACjC,qCAAqC;IACrC,OAAO,EAAE,aAAa,CAAC;IACvB,+BAA+B;IAC/B,OAAO,EAAE,WAAW,CAAC;IACrB,kCAAkC;IAClC,OAAO,EAAE,WAAW,CAAC;IACrB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IAClC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IAClC,iDAAiD;IACjD,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvD,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,WAAW;IAC3B,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAC;IAEX,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;IAGlB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,KAAK,gBAAgB,CAAC;IACxE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IACrC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,MAAM,CAAC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,cAAc,CAAC,EAAE,CAChB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,aAAa,KAClB,WAAW,EAAE,CAAC;IAGnB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAMD,MAAM,MAAM,mBAAmB,GAC5B,sBAAsB,GACtB,uBAAuB,GACvB,yBAAyB,GACzB,yBAAyB,GACzB,sBAAsB,GACtB,sBAAsB,CAAC;AAE1B,MAAM,WAAW,uBAAuB;IACvC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IAC1C,IAAI,EAAE,yBAAyB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,0BAA0B;IAC1C,IAAI,EAAE,yBAAyB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,kBAAkB,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACvC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACvC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,eAAe,GACxB,uBAAuB,GACvB,wBAAwB,GACxB,0BAA0B,GAC1B,0BAA0B,GAC1B,uBAAuB,GACvB,uBAAuB,CAAC;AAM3B,MAAM,WAAW,kBAAkB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC3C,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAChC,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAC;IACvB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,mCAAmC;IACnC,eAAe,EAAE,mBAAmB,EAAE,CAAC;IACvC,uCAAuC;IACvC,eAAe,EAAE,qBAAqB,EAAE,CAAC;IACzC,8BAA8B;IAC9B,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,6BAA6B;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,gDAAgD;IAChD,qBAAqB,EAAE,2BAA2B,EAAE,CAAC;CACrD;AAMD,MAAM,MAAM,UAAU,GAEnB,WAAW,GACX,QAAQ,GACR,OAAO,GACP,SAAS,GACT,QAAQ,GAER,MAAM,GACN,MAAM,GACN,SAAS,GACT,SAAS,GACT,UAAU,GACV,UAAU,GAEV,OAAO,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAChC,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IAC3B,gDAAgD;IAChD,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC5B,gCAAgC;IAChC,MAAM,EAAE,UAAU,CAAC;IACnB,oDAAoD;IACpD,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,eAAO,MAAM,qBAAqB;;;;CAIxB,CAAC;AAEX,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;CAsB3B,CAAC;AAMX,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AACrD,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAC3D,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CAClB"}

package/packages/typescript/src/features/advanced-capabilities/form/types.js

@@ -0,0 +1,71 @@
+/**
+ * @module types
+ * @description Core type definitions for the Form Plugin
+ *
+ * ## The Core Insight
+ *
+ * Forms are **guardrails for agent-guided user journeys**.
+ *
+ * Without structure, agents wander. They forget what they're collecting,
+ * miss required information, and can't reliably guide users to outcomes.
+ * These types define the rails that keep agents on track.
+ *
+ * - **FormDefinition** = The journey map (what stops are required)
+ * - **FormControl** = A stop on the journey (what info to collect)
+ * - **FormSession** = Progress through the journey (where we are)
+ * - **FormSubmission** = Journey complete (the outcome)
+ *
+ * ## Design Principles
+ *
+ * 1. **Agent-Native**: Designed for conversational, asynchronous interactions.
+ *    No form UI - the agent extracts data and guides the conversation.
+ *
+ * 2. **Future-Compatible**: Many fields are optional with sensible defaults.
+ *    The `meta` field on most interfaces allows arbitrary extension.
+ *
+ * 3. **Scoped Sessions**: Sessions are keyed by (entityId + roomId) because
+ *    a user might be on different journeys in different rooms.
+ *
+ * 4. **Effort-Aware**: Form data is retained based on user effort invested.
+ *    Someone who spent 2 hours deserves longer retention than 2 minutes.
+ *
+ * 5. **TypeScript-First**: Types use discriminated unions, generics, and
+ *    template literals for excellent IDE support and type safety.
+ */
+// ============================================================================
+// DEFAULTS
+// ============================================================================
+export const FORM_CONTROL_DEFAULTS = {
+    type: "text",
+    required: false,
+    confirmThreshold: 0.8,
+};
+export const FORM_DEFINITION_DEFAULTS = {
+    version: 1,
+    status: "active",
+    ux: {
+        allowUndo: true,
+        allowSkip: true,
+        maxUndoSteps: 5,
+        showExamples: true,
+        showExplanations: true,
+        allowAutofill: true,
+    },
+    ttl: {
+        minDays: 14,
+        maxDays: 90,
+        effortMultiplier: 0.5,
+    },
+    nudge: {
+        enabled: true,
+        afterInactiveHours: 48,
+        maxNudges: 3,
+    },
+    debug: false,
+};
+// ============================================================================
+// COMPONENT TYPES - For storage
+// ============================================================================
+export const FORM_SESSION_COMPONENT = "form_session";
+export const FORM_SUBMISSION_COMPONENT = "form_submission";
+export const FORM_AUTOFILL_COMPONENT = "form_autofill";