@objectstack/service-ai 4.0.0

package/dist/index.d.ts

@@ -0,0 +1,3406 @@
+import { AIToolDefinition, AIToolCall, AIToolResult, IAIService, IAIConversationService, LLMAdapter, Logger, AIMessage, AIRequestOptions, AIResult, AIStreamEvent, ChatWithToolsOptions, AIConversation, IDataEngine, IMetadataService } from '@objectstack/spec/contracts';
+export { LLMAdapter } from '@objectstack/spec/contracts';
+import { Plugin, PluginContext } from '@objectstack/core';
+import { Agent } from '@objectstack/spec';
+import { z } from 'zod';
+import * as _objectstack_spec_data from '@objectstack/spec/data';
+
+/**
+ * Handler function for a registered tool.
+ *
+ * Receives parsed arguments and returns the tool output as a string.
+ */
+type ToolHandler = (args: Record<string, unknown>) => Promise<string> | string;
+/**
+ * ToolRegistry — Central registry for AI-callable tools.
+ *
+ * Plugins register tools (metadata helpers, data queries, business actions)
+ * during the `ai:ready` hook.  The AI service resolves tool calls against
+ * this registry and feeds the results back to the LLM.
+ */
+declare class ToolRegistry {
+    private readonly definitions;
+    private readonly handlers;
+    /**
+     * Register a tool with its definition and handler.
+     * @param definition - Tool definition (name, description, parameters schema)
+     * @param handler    - Async function that executes the tool
+     */
+    register(definition: AIToolDefinition, handler: ToolHandler): void;
+    /**
+     * Unregister a tool by name.
+     */
+    unregister(name: string): void;
+    /**
+     * Check whether a tool is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * Get the definition for a registered tool.
+     */
+    getDefinition(name: string): AIToolDefinition | undefined;
+    /**
+     * Return all registered tool definitions.
+     */
+    getAll(): AIToolDefinition[];
+    /** Number of registered tools. */
+    get size(): number;
+    /** All registered tool names. */
+    names(): string[];
+    /**
+     * Execute a tool call and return the result.
+     */
+    execute(toolCall: AIToolCall): Promise<AIToolResult>;
+    /**
+     * Execute multiple tool calls in parallel.
+     */
+    executeAll(toolCalls: AIToolCall[]): Promise<AIToolResult[]>;
+    /**
+     * Clear all registered tools.
+     */
+    clear(): void;
+}
+
+/**
+ * Configuration for AIService.
+ */
+interface AIServiceConfig {
+    /** LLM adapter to delegate calls to (defaults to MemoryLLMAdapter). */
+    adapter?: LLMAdapter;
+    /** Logger instance. */
+    logger?: Logger;
+    /** Pre-registered tools. */
+    toolRegistry?: ToolRegistry;
+    /** Conversation service (defaults to InMemoryConversationService). */
+    conversationService?: IAIConversationService;
+}
+/**
+ * AIService — Unified AI capability service.
+ *
+ * Implements {@link IAIService} by delegating to a pluggable {@link LLMAdapter}
+ * and managing tools and conversations through dedicated sub-components:
+ *
+ * | Component | Responsibility |
+ * |:---|:---|
+ * | {@link LLMAdapter} | LLM provider abstraction (chat, complete, stream, embed) |
+ * | {@link ToolRegistry} | Tool definition storage & execution |
+ * | {@link IAIConversationService} | Conversation CRUD & message persistence |
+ *
+ * The service is registered as `'ai'` in the kernel service registry by
+ * the {@link AIServicePlugin}.
+ */
+declare class AIService implements IAIService {
+    private readonly adapter;
+    private readonly logger;
+    readonly toolRegistry: ToolRegistry;
+    readonly conversationService: IAIConversationService;
+    constructor(config?: AIServiceConfig);
+    /** The name of the active LLM adapter. */
+    get adapterName(): string;
+    chat(messages: AIMessage[], options?: AIRequestOptions): Promise<AIResult>;
+    complete(prompt: string, options?: AIRequestOptions): Promise<AIResult>;
+    streamChat(messages: AIMessage[], options?: AIRequestOptions): AsyncIterable<AIStreamEvent>;
+    embed(input: string | string[], model?: string): Promise<number[][]>;
+    listModels(): Promise<string[]>;
+    /** Default maximum iterations for the tool call loop. */
+    static readonly DEFAULT_MAX_ITERATIONS = 10;
+    /**
+     * Chat with automatic tool call resolution.
+     *
+     * 1. Merges registered tool definitions into `options.tools`.
+     * 2. Calls the LLM adapter.
+     * 3. If the response contains `toolCalls`, executes them via the
+     *    {@link ToolRegistry}, appends tool results as `role: 'tool'`
+     *    messages, and loops back to step 2.
+     * 4. Repeats until the model produces a final text response or the
+     *    maximum number of iterations (`maxIterations`) is reached.
+     */
+    chatWithTools(messages: AIMessage[], options?: ChatWithToolsOptions): Promise<AIResult>;
+}
+
+/**
+ * Configuration options for the AIServicePlugin.
+ */
+interface AIServicePluginOptions {
+    /** LLM adapter to use (defaults to MemoryLLMAdapter). */
+    adapter?: LLMAdapter;
+    /** Enable debug logging. */
+    debug?: boolean;
+    /** Explicit conversation service override. When set, auto-detection is skipped. */
+    conversationService?: IAIConversationService;
+}
+/**
+ * AIServicePlugin — Kernel plugin for the unified AI capability service.
+ *
+ * Lifecycle:
+ * 1. **init** — Creates {@link AIService}, registers as `'ai'` service.
+ *    If an existing AI service is already registered, it is replaced.
+ * 2. **start** — Triggers `'ai:ready'` hook so other plugins can register
+ *    tools or extend the service.  Registers REST/SSE routes.
+ * 3. **destroy** — Cleans up references.
+ *
+ * @example
+ * ```ts
+ * import { LiteKernel } from '@objectstack/core';
+ * import { AIServicePlugin } from '@objectstack/service-ai';
+ *
+ * const kernel = new LiteKernel();
+ * kernel.use(new AIServicePlugin());
+ * await kernel.bootstrap();
+ *
+ * const ai = kernel.getService<IAIService>('ai');
+ * const result = await ai.chat([{ role: 'user', content: 'Hello' }]);
+ * ```
+ */
+declare class AIServicePlugin implements Plugin {
+    name: string;
+    version: string;
+    type: "standard";
+    dependencies: string[];
+    private service?;
+    private readonly options;
+    constructor(options?: AIServicePluginOptions);
+    init(ctx: PluginContext): Promise<void>;
+    start(ctx: PluginContext): Promise<void>;
+    destroy(): Promise<void>;
+}
+
+/**
+ * MemoryLLMAdapter — deterministic in-memory adapter for testing & development.
+ *
+ * Always echoes back the last user message prefixed with "[memory] ".
+ * Useful for unit tests, CI pipelines, and local dev without an LLM key.
+ */
+declare class MemoryLLMAdapter implements LLMAdapter {
+    readonly name = "memory";
+    chat(messages: AIMessage[], options?: AIRequestOptions): Promise<AIResult>;
+    complete(prompt: string, options?: AIRequestOptions): Promise<AIResult>;
+    streamChat(messages: AIMessage[], _options?: AIRequestOptions): AsyncIterable<AIStreamEvent>;
+    embed(input: string | string[]): Promise<number[][]>;
+    listModels(): Promise<string[]>;
+}
+
+/**
+ * InMemoryConversationService — Reference implementation of IAIConversationService.
+ *
+ * Stores conversations in a simple Map.  Suitable for development, testing,
+ * and single-process deployments.  Production environments should replace
+ * this with a persistent implementation (e.g., backed by ObjectQL/SQL).
+ */
+declare class InMemoryConversationService implements IAIConversationService {
+    private readonly store;
+    private counter;
+    create(options?: {
+        title?: string;
+        agentId?: string;
+        userId?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<AIConversation>;
+    get(conversationId: string): Promise<AIConversation | null>;
+    list(options?: {
+        userId?: string;
+        agentId?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<AIConversation[]>;
+    addMessage(conversationId: string, message: AIMessage): Promise<AIConversation>;
+    delete(conversationId: string): Promise<void>;
+    /** Total number of stored conversations. */
+    get size(): number;
+    /** Clear all conversations. */
+    clear(): void;
+}
+
+/**
+ * ObjectQLConversationService — Persistent implementation of IAIConversationService.
+ *
+ * Delegates all storage to an {@link IDataEngine} instance, using the
+ * `ai_conversations` and `ai_messages` objects. This decouples the service
+ * from any specific database driver (Turso, Postgres, SQLite, etc.).
+ *
+ * Production environments should use this implementation to ensure
+ * conversation history survives service restarts.
+ */
+declare class ObjectQLConversationService implements IAIConversationService {
+    private readonly engine;
+    constructor(engine: IDataEngine);
+    create(options?: {
+        title?: string;
+        agentId?: string;
+        userId?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<AIConversation>;
+    get(conversationId: string): Promise<AIConversation | null>;
+    list(options?: {
+        userId?: string;
+        agentId?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<AIConversation[]>;
+    addMessage(conversationId: string, message: AIMessage): Promise<AIConversation>;
+    delete(conversationId: string): Promise<void>;
+    /**
+     * Safely parse a JSON string, returning `undefined` on failure.
+     */
+    private safeParse;
+    /**
+     * Map a database row + message rows to an AIConversation.
+     */
+    private toConversation;
+    /**
+     * Map a database row to an AIMessage.
+     */
+    private toMessage;
+}
+
+/**
+ * Services required by the built-in data tools.
+ *
+ * These are provided by the kernel at `ai:ready` time and closed over
+ * by the handler functions so they stay framework-agnostic.
+ */
+interface DataToolContext {
+    /** ObjectQL data engine for record-level operations. */
+    dataEngine: IDataEngine;
+    /** Metadata service for schema/object introspection. */
+    metadataService: IMetadataService;
+}
+/** All built-in data tool definitions. */
+declare const DATA_TOOL_DEFINITIONS: AIToolDefinition[];
+/**
+ * Register all built-in data tools on the given {@link ToolRegistry}.
+ *
+ * Typically called from the `ai:ready` hook after both the data engine
+ * and metadata service are available.
+ *
+ * @example
+ * ```ts
+ * ctx.hook('ai:ready', async (aiService) => {
+ *   const dataEngine = ctx.getService<IDataEngine>('data');
+ *   const metadataService = ctx.getService<IMetadataService>('metadata');
+ *   registerDataTools(aiService.toolRegistry, { dataEngine, metadataService });
+ * });
+ * ```
+ */
+declare function registerDataTools(registry: ToolRegistry, context: DataToolContext): void;
+
+/**
+ * Context passed alongside a user message when chatting with an agent.
+ *
+ * UI clients set these fields to tell the agent which object, record,
+ * or view the user is currently looking at so it can provide contextual
+ * answers without additional tool calls.
+ */
+interface AgentChatContext {
+    /** Current object the user is viewing (e.g. "account") */
+    objectName?: string;
+    /** Currently selected record ID */
+    recordId?: string;
+    /** Current view name */
+    viewName?: string;
+}
+/**
+ * AgentRuntime — Resolves an agent definition into runnable chat parameters.
+ *
+ * Responsibilities:
+ * 1. Load & validate agent metadata from the metadata service.
+ * 2. Build the system prompt from agent `instructions` + UI context.
+ * 3. Derive {@link AIRequestOptions} from agent `model` and `tools`.
+ * 4. Map agent tool references to concrete {@link AIToolDefinition}s
+ *    registered in the {@link ToolRegistry}.
+ */
+declare class AgentRuntime {
+    private readonly metadataService;
+    constructor(metadataService: IMetadataService);
+    /**
+     * Load and validate an agent definition by name.
+     *
+     * The raw metadata is validated through {@link AgentSchema} to ensure
+     * required fields (`instructions`, `name`, `role`, etc.) are present
+     * and well-typed.  Returns `undefined` when the agent does not exist
+     * or validation fails.
+     */
+    loadAgent(agentName: string): Promise<Agent | undefined>;
+    /**
+     * Build the system message(s) that should be prepended to the
+     * conversation when chatting with the given agent.
+     */
+    buildSystemMessages(agent: Agent, context?: AgentChatContext): AIMessage[];
+    /**
+     * Derive {@link AIRequestOptions} from an agent definition.
+     *
+     * Tool references declared in `agent.tools` are resolved by name against
+     * `availableTools` (i.e. the full set of ToolRegistry definitions).
+     * Any unresolved references (tools the agent declares but that are not
+     * registered) are silently skipped — this is intentional so that agents
+     * can be defined before all tools are available.
+     *
+     * @param agent          - The agent definition to derive options from
+     * @param availableTools - All tool definitions currently registered in the ToolRegistry
+     * @returns Request options with model config and resolved tool definitions
+     */
+    buildRequestOptions(agent: Agent, availableTools: AIToolDefinition[]): AIRequestOptions;
+}
+
+/**
+ * Built-in `data_chat` agent definition.
+ *
+ * This agent powers the Airtable-style data conversation Chatbot.
+ * It is registered automatically by the AI service plugin when a
+ * data engine is available.
+ *
+ * @example
+ * ```
+ * POST /api/v1/ai/agents/data_chat/chat
+ * {
+ *   "messages": [{ "role": "user", "content": "Show me all active accounts" }],
+ *   "context": { "objectName": "account" }
+ * }
+ * ```
+ */
+declare const DATA_CHAT_AGENT: Agent;
+
+/**
+ * XState-inspired State Machine Protocol
+ * Used to define strict business logic constraints and lifecycle management.
+ * Prevent AI "hallucinations" by enforcing valid valid transitions.
+ */
+/**
+ * References a named action (side effect)
+ * Can be a script, a webhook, or a field update.
+ */
+declare const ActionRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    type: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>]>;
+/**
+ * State Transition Definition
+ * "When EVENT happens, if GUARD is true, go to TARGET and run ACTIONS"
+ */
+declare const TransitionSchema: z.ZodObject<{
+    target: z.ZodOptional<z.ZodString>;
+    cond: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        type: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>]>>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        type: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>]>>>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ActionRef = z.infer<typeof ActionRefSchema>;
+type Transition = z.infer<typeof TransitionSchema>;
+type StateNodeConfig = {
+    type?: 'atomic' | 'compound' | 'parallel' | 'final' | 'history';
+    entry?: ActionRef[];
+    exit?: ActionRef[];
+    on?: Record<string, string | Transition | Transition[]>;
+    always?: Transition[];
+    initial?: string;
+    states?: Record<string, StateNodeConfig>;
+    meta?: {
+        label?: string;
+        description?: string;
+        color?: string;
+        aiInstructions?: string;
+    };
+};
+
+/**
+ * ai_conversations — AI Conversation Object
+ *
+ * Stores conversation metadata for persistent AI conversation management.
+ * Messages are stored separately in `ai_messages` to support efficient
+ * querying and pagination.
+ *
+ * @namespace ai
+ */
+declare const AiConversationObject: Omit<{
+    name: string;
+    active: boolean;
+    isSystem: boolean;
+    abstract: boolean;
+    datasource: string;
+    fields: Record<string, {
+        type: "number" | "boolean" | "file" | "json" | "text" | "avatar" | "vector" | "date" | "tags" | "lookup" | "url" | "textarea" | "email" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress";
+        required: boolean;
+        searchable: boolean;
+        multiple: boolean;
+        unique: boolean;
+        deleteBehavior: "set_null" | "cascade" | "restrict";
+        auditTrail: boolean;
+        hidden: boolean;
+        readonly: boolean;
+        sortable: boolean;
+        index: boolean;
+        externalId: boolean;
+        name?: string | undefined;
+        label?: string | undefined;
+        description?: string | undefined;
+        format?: string | undefined;
+        columnName?: string | undefined;
+        defaultValue?: unknown;
+        maxLength?: number | undefined;
+        minLength?: number | undefined;
+        precision?: number | undefined;
+        scale?: number | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        options?: {
+            label: string;
+            value: string;
+            color?: string | undefined;
+            default?: boolean | undefined;
+        }[] | undefined;
+        reference?: string | undefined;
+        referenceFilters?: string[] | undefined;
+        writeRequiresMasterRead?: boolean | undefined;
+        expression?: string | undefined;
+        summaryOperations?: {
+            object: string;
+            field: string;
+            function: "count" | "sum" | "avg" | "min" | "max";
+        } | undefined;
+        language?: string | undefined;
+        theme?: string | undefined;
+        lineNumbers?: boolean | undefined;
+        maxRating?: number | undefined;
+        allowHalf?: boolean | undefined;
+        displayMap?: boolean | undefined;
+        allowGeocoding?: boolean | undefined;
+        addressFormat?: "us" | "uk" | "international" | undefined;
+        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+        allowAlpha?: boolean | undefined;
+        presetColors?: string[] | undefined;
+        step?: number | undefined;
+        showValue?: boolean | undefined;
+        marks?: Record<string, string> | undefined;
+        barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+        qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+        displayValue?: boolean | undefined;
+        allowScanning?: boolean | undefined;
+        currencyConfig?: {
+            precision: number;
+            currencyMode: "dynamic" | "fixed";
+            defaultCurrency: string;
+        } | undefined;
+        vectorConfig?: {
+            dimensions: number;
+            distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+            normalized: boolean;
+            indexed: boolean;
+            indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+        } | undefined;
+        fileAttachmentConfig?: {
+            virusScan: boolean;
+            virusScanOnUpload: boolean;
+            quarantineOnThreat: boolean;
+            allowMultiple: boolean;
+            allowReplace: boolean;
+            allowDelete: boolean;
+            requireUpload: boolean;
+            extractMetadata: boolean;
+            extractText: boolean;
+            versioningEnabled: boolean;
+            publicRead: boolean;
+            presignedUrlExpiry: number;
+            minSize?: number | undefined;
+            maxSize?: number | undefined;
+            allowedTypes?: string[] | undefined;
+            blockedTypes?: string[] | undefined;
+            allowedMimeTypes?: string[] | undefined;
+            blockedMimeTypes?: string[] | undefined;
+            virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+            storageProvider?: string | undefined;
+            storageBucket?: string | undefined;
+            storagePrefix?: string | undefined;
+            imageValidation?: {
+                generateThumbnails: boolean;
+                preserveMetadata: boolean;
+                autoRotate: boolean;
+                minWidth?: number | undefined;
+                maxWidth?: number | undefined;
+                minHeight?: number | undefined;
+                maxHeight?: number | undefined;
+                aspectRatio?: string | undefined;
+                thumbnailSizes?: {
+                    name: string;
+                    width: number;
+                    height: number;
+                    crop: boolean;
+                }[] | undefined;
+            } | undefined;
+            maxVersions?: number | undefined;
+        } | undefined;
+        encryptionConfig?: {
+            enabled: boolean;
+            algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+            keyManagement: {
+                provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                keyId?: string | undefined;
+                rotationPolicy?: {
+                    enabled: boolean;
+                    frequencyDays: number;
+                    retainOldVersions: number;
+                    autoRotate: boolean;
+                } | undefined;
+            };
+            scope: "database" | "field" | "record" | "table";
+            deterministicEncryption: boolean;
+            searchableEncryption: boolean;
+        } | undefined;
+        maskingRule?: {
+            field: string;
+            strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+            preserveFormat: boolean;
+            preserveLength: boolean;
+            pattern?: string | undefined;
+            roles?: string[] | undefined;
+            exemptRoles?: string[] | undefined;
+        } | undefined;
+        dependencies?: string[] | undefined;
+        cached?: {
+            enabled: boolean;
+            ttl: number;
+            invalidateOn: string[];
+        } | undefined;
+        dataQuality?: {
+            uniqueness: boolean;
+            completeness: number;
+            accuracy?: {
+                source: string;
+                threshold: number;
+            } | undefined;
+        } | undefined;
+        group?: string | undefined;
+        conditionalRequired?: string | undefined;
+        inlineHelpText?: string | undefined;
+        trackFeedHistory?: boolean | undefined;
+        caseSensitive?: boolean | undefined;
+        autonumberFormat?: string | undefined;
+    }>;
+    label?: string | undefined;
+    pluralLabel?: string | undefined;
+    description?: string | undefined;
+    icon?: string | undefined;
+    namespace?: string | undefined;
+    tags?: string[] | undefined;
+    tableName?: string | undefined;
+    indexes?: {
+        fields: string[];
+        type: "hash" | "btree" | "gin" | "gist" | "fulltext";
+        unique: boolean;
+        name?: string | undefined;
+        partial?: string | undefined;
+    }[] | undefined;
+    tenancy?: {
+        enabled: boolean;
+        strategy: "shared" | "isolated" | "hybrid";
+        tenantField: string;
+        crossTenantAccess: boolean;
+    } | undefined;
+    softDelete?: {
+        enabled: boolean;
+        field: string;
+        cascadeDelete: boolean;
+    } | undefined;
+    versioning?: {
+        enabled: boolean;
+        strategy: "snapshot" | "delta" | "event-sourcing";
+        versionField: string;
+        retentionDays?: number | undefined;
+    } | undefined;
+    partitioning?: {
+        enabled: boolean;
+        strategy: "hash" | "range" | "list";
+        key: string;
+        interval?: string | undefined;
+    } | undefined;
+    cdc?: {
+        enabled: boolean;
+        events: ("update" | "delete" | "insert")[];
+        destination: string;
+    } | undefined;
+    validations?: _objectstack_spec_data.BaseValidationRuleShape[] | undefined;
+    stateMachines?: Record<string, {
+        id: string;
+        initial: string;
+        states: Record<string, StateNodeConfig>;
+        description?: string | undefined;
+        contextSchema?: Record<string, unknown> | undefined;
+        on?: Record<string, string | {
+            target?: string | undefined;
+            cond?: string | {
+                type: string;
+                params?: Record<string, unknown> | undefined;
+            } | undefined;
+            actions?: (string | {
+                type: string;
+                params?: Record<string, unknown> | undefined;
+            })[] | undefined;
+            description?: string | undefined;
+        } | {
+            target?: string | undefined;
+            cond?: string | {
+                type: string;
+                params?: Record<string, unknown> | undefined;
+            } | undefined;
+            actions?: (string | {
+                type: string;
+                params?: Record<string, unknown> | undefined;
+            })[] | undefined;
+            description?: string | undefined;
+        }[]> | undefined;
+    }> | undefined;
+    displayNameField?: string | undefined;
+    recordName?: {
+        type: "text" | "autonumber";
+        displayFormat?: string | undefined;
+        startNumber?: number | undefined;
+    } | undefined;
+    titleFormat?: string | undefined;
+    compactLayout?: string[] | undefined;
+    search?: {
+        fields: string[];
+        displayFields?: string[] | undefined;
+        filters?: string[] | undefined;
+    } | undefined;
+    enable?: {
+        trackHistory: boolean;
+        searchable: boolean;
+        apiEnabled: boolean;
+        files: boolean;
+        feeds: boolean;
+        activities: boolean;
+        trash: boolean;
+        mru: boolean;
+        clone: boolean;
+        apiMethods?: ("search" | "upsert" | "list" | "update" | "delete" | "history" | "get" | "create" | "bulk" | "aggregate" | "restore" | "purge" | "import" | "export")[] | undefined;
+    } | undefined;
+    recordTypes?: string[] | undefined;
+    sharingModel?: "private" | "full" | "read" | "read_write" | undefined;
+    keyPrefix?: string | undefined;
+    actions?: {
+        name: string;
+        label: string | {
+            key: string;
+            defaultValue?: string | undefined;
+            params?: Record<string, string | number | boolean> | undefined;
+        };
+        type: "url" | "script" | "modal" | "flow" | "api";
+        refreshAfter: boolean;
+        objectName?: string | undefined;
+        icon?: string | undefined;
+        locations?: ("list_toolbar" | "list_item" | "record_header" | "record_more" | "record_related" | "global_nav")[] | undefined;
+        component?: "action:button" | "action:icon" | "action:menu" | "action:group" | undefined;
+        target?: string | undefined;
+        execute?: string | undefined;
+        params?: {
+            name: string;
+            label: string | {
+                key: string;
+                defaultValue?: string | undefined;
+                params?: Record<string, string | number | boolean> | undefined;
+            };
+            type: "number" | "boolean" | "date" | "lookup" | "file" | "url" | "json" | "text" | "textarea" | "email" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
+            required: boolean;
+            options?: {
+                label: string | {
+                    key: string;
+                    defaultValue?: string | undefined;
+                    params?: Record<string, string | number | boolean> | undefined;
+                };
+                value: string;
+            }[] | undefined;
+        }[] | undefined;
+        variant?: "link" | "primary" | "secondary" | "danger" | "ghost" | undefined;
+        confirmText?: string | {
+            key: string;
+            defaultValue?: string | undefined;
+            params?: Record<string, string | number | boolean> | undefined;
+        } | undefined;
+        successMessage?: string | {
+            key: string;
+            defaultValue?: string | undefined;
+            params?: Record<string, string | number | boolean> | undefined;
+        } | undefined;
+        visible?: string | undefined;
+        disabled?: string | boolean | undefined;
+        shortcut?: string | undefined;
+        bulkEnabled?: boolean | undefined;
+        timeout?: number | undefined;
+        aria?: {
+            ariaLabel?: string | {
+                key: string;
+                defaultValue?: string | undefined;
+                params?: Record<string, string | number | boolean> | undefined;
+            } | undefined;
+            ariaDescribedBy?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+}, "fields"> & Pick<{
+    readonly namespace: "ai";
+    readonly name: "conversations";
+    readonly label: "AI Conversation";
+    readonly pluralLabel: "AI Conversations";
+    readonly icon: "message-square";
+    readonly isSystem: true;
+    readonly description: "Persistent AI conversation metadata";
+    readonly fields: {
+        readonly id: {
+            readonly format?: string | undefined;
+            readonly expression?: string | undefined;
+            readonly readonly?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly name?: string | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "record" | "field" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly label?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly description?: string | undefined;
+            readonly columnName?: string | undefined;
+            readonly required?: boolean | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly theme?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "hnsw" | "ivfflat" | "flat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly group?: string | undefined;
+            readonly conditionalRequired?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly type: "text";
+        };
+        readonly title: {
+            readonly format?: string | undefined;
+            readonly expression?: string | undefined;
+            readonly readonly?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly name?: string | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "record" | "field" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly label?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly description?: string | undefined;
+            readonly columnName?: string | undefined;
+            readonly required?: boolean | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly theme?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "hnsw" | "ivfflat" | "flat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly group?: string | undefined;
+            readonly conditionalRequired?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly type: "text";
+        };
+        readonly agent_id: {
+            readonly format?: string | undefined;
+            readonly expression?: string | undefined;
+            readonly readonly?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly name?: string | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "record" | "field" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly label?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly description?: string | undefined;
+            readonly columnName?: string | undefined;
+            readonly required?: boolean | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly theme?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "hnsw" | "ivfflat" | "flat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly group?: string | undefined;
+            readonly conditionalRequired?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly type: "text";
+        };
+        readonly user_id: {
+            readonly format?: string | undefined;
+            readonly expression?: string | undefined;
+            readonly readonly?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly name?: string | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "record" | "field" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly label?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly description?: string | undefined;
+            readonly columnName?: string | undefined;
+            readonly required?: boolean | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly theme?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "hnsw" | "ivfflat" | "flat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly group?: string | undefined;
+            readonly conditionalRequired?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly type: "text";
+        };
+        readonly metadata: {
+            readonly format?: string | undefined;
+            readonly expression?: string | undefined;
+            readonly readonly?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly name?: string | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "record" | "field" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly label?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly description?: string | undefined;
+            readonly columnName?: string | undefined;
+            readonly required?: boolean | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly theme?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "hnsw" | "ivfflat" | "flat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly group?: string | undefined;
+            readonly conditionalRequired?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly type: "textarea";
+        };
+        readonly created_at: {
+            readonly format?: string | undefined;
+            readonly expression?: string | undefined;
+            readonly readonly?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly name?: string | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "record" | "field" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly label?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly description?: string | undefined;
+            readonly columnName?: string | undefined;
+            readonly required?: boolean | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly theme?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "hnsw" | "ivfflat" | "flat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly group?: string | undefined;
+            readonly conditionalRequired?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly type: "datetime";
+        };
+        readonly updated_at: {
+            readonly format?: string | undefined;
+            readonly expression?: string | undefined;
+            readonly readonly?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly name?: string | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "record" | "field" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly label?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly description?: string | undefined;
+            readonly columnName?: string | undefined;
+            readonly required?: boolean | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly theme?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "hnsw" | "ivfflat" | "flat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly group?: string | undefined;
+            readonly conditionalRequired?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly type: "datetime";
+        };
+    };
+    readonly indexes: [{
+        readonly fields: ["user_id"];
+    }, {
+        readonly fields: ["agent_id"];
+    }, {
+        readonly fields: ["created_at"];
+    }];
+    readonly enable: {
+        readonly trackHistory: false;
+        readonly searchable: false;
+        readonly apiEnabled: true;
+        readonly apiMethods: ["get", "list", "create", "update", "delete"];
+        readonly trash: false;
+        readonly mru: false;
+    };
+}, "fields">;
+
+/**
+ * ai_messages — AI Message Object
+ *
+ * Stores individual messages within an AI conversation.
+ * Each message belongs to a conversation via `conversation_id` foreign key.
+ *
+ * @namespace ai
+ */
+declare const AiMessageObject: Omit<{
+    name: string;
+    active: boolean;
+    isSystem: boolean;
+    abstract: boolean;
+    datasource: string;
+    fields: Record<string, {
+        type: "number" | "boolean" | "file" | "json" | "text" | "avatar" | "vector" | "date" | "tags" | "lookup" | "url" | "textarea" | "email" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress";
+        required: boolean;
+        searchable: boolean;
+        multiple: boolean;
+        unique: boolean;
+        deleteBehavior: "set_null" | "cascade" | "restrict";
+        auditTrail: boolean;
+        hidden: boolean;
+        readonly: boolean;
+        sortable: boolean;
+        index: boolean;
+        externalId: boolean;
+        name?: string | undefined;
+        label?: string | undefined;
+        description?: string | undefined;
+        format?: string | undefined;
+        columnName?: string | undefined;
+        defaultValue?: unknown;
+        maxLength?: number | undefined;
+        minLength?: number | undefined;
+        precision?: number | undefined;
+        scale?: number | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        options?: {
+            label: string;
+            value: string;
+            color?: string | undefined;
+            default?: boolean | undefined;
+        }[] | undefined;
+        reference?: string | undefined;
+        referenceFilters?: string[] | undefined;
+        writeRequiresMasterRead?: boolean | undefined;
+        expression?: string | undefined;
+        summaryOperations?: {
+            object: string;
+            field: string;
+            function: "count" | "sum" | "avg" | "min" | "max";
+        } | undefined;
+        language?: string | undefined;
+        theme?: string | undefined;
+        lineNumbers?: boolean | undefined;
+        maxRating?: number | undefined;
+        allowHalf?: boolean | undefined;
+        displayMap?: boolean | undefined;
+        allowGeocoding?: boolean | undefined;
+        addressFormat?: "us" | "uk" | "international" | undefined;
+        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+        allowAlpha?: boolean | undefined;
+        presetColors?: string[] | undefined;
+        step?: number | undefined;
+        showValue?: boolean | undefined;
+        marks?: Record<string, string> | undefined;
+        barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+        qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+        displayValue?: boolean | undefined;
+        allowScanning?: boolean | undefined;
+        currencyConfig?: {
+            precision: number;
+            currencyMode: "dynamic" | "fixed";
+            defaultCurrency: string;
+        } | undefined;
+        vectorConfig?: {
+            dimensions: number;
+            distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+            normalized: boolean;
+            indexed: boolean;
+            indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+        } | undefined;
+        fileAttachmentConfig?: {
+            virusScan: boolean;
+            virusScanOnUpload: boolean;
+            quarantineOnThreat: boolean;
+            allowMultiple: boolean;
+            allowReplace: boolean;
+            allowDelete: boolean;
+            requireUpload: boolean;
+            extractMetadata: boolean;
+            extractText: boolean;
+            versioningEnabled: boolean;
+            publicRead: boolean;
+            presignedUrlExpiry: number;
+            minSize?: number | undefined;
+            maxSize?: number | undefined;
+            allowedTypes?: string[] | undefined;
+            blockedTypes?: string[] | undefined;
+            allowedMimeTypes?: string[] | undefined;
+            blockedMimeTypes?: string[] | undefined;
+            virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+            storageProvider?: string | undefined;
+            storageBucket?: string | undefined;
+            storagePrefix?: string | undefined;
+            imageValidation?: {
+                generateThumbnails: boolean;
+                preserveMetadata: boolean;
+                autoRotate: boolean;
+                minWidth?: number | undefined;
+                maxWidth?: number | undefined;
+                minHeight?: number | undefined;
+                maxHeight?: number | undefined;
+                aspectRatio?: string | undefined;
+                thumbnailSizes?: {
+                    name: string;
+                    width: number;
+                    height: number;
+                    crop: boolean;
+                }[] | undefined;
+            } | undefined;
+            maxVersions?: number | undefined;
+        } | undefined;
+        encryptionConfig?: {
+            enabled: boolean;
+            algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+            keyManagement: {
+                provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                keyId?: string | undefined;
+                rotationPolicy?: {
+                    enabled: boolean;
+                    frequencyDays: number;
+                    retainOldVersions: number;
+                    autoRotate: boolean;
+                } | undefined;
+            };
+            scope: "database" | "field" | "record" | "table";
+            deterministicEncryption: boolean;
+            searchableEncryption: boolean;
+        } | undefined;
+        maskingRule?: {
+            field: string;
+            strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+            preserveFormat: boolean;
+            preserveLength: boolean;
+            pattern?: string | undefined;
+            roles?: string[] | undefined;
+            exemptRoles?: string[] | undefined;
+        } | undefined;
+        dependencies?: string[] | undefined;
+        cached?: {
+            enabled: boolean;
+            ttl: number;
+            invalidateOn: string[];
+        } | undefined;
+        dataQuality?: {
+            uniqueness: boolean;
+            completeness: number;
+            accuracy?: {
+                source: string;
+                threshold: number;
+            } | undefined;
+        } | undefined;
+        group?: string | undefined;
+        conditionalRequired?: string | undefined;
+        inlineHelpText?: string | undefined;
+        trackFeedHistory?: boolean | undefined;
+        caseSensitive?: boolean | undefined;
+        autonumberFormat?: string | undefined;
+    }>;
+    label?: string | undefined;
+    pluralLabel?: string | undefined;
+    description?: string | undefined;
+    icon?: string | undefined;
+    namespace?: string | undefined;
+    tags?: string[] | undefined;
+    tableName?: string | undefined;
+    indexes?: {
+        fields: string[];
+        type: "hash" | "btree" | "gin" | "gist" | "fulltext";
+        unique: boolean;
+        name?: string | undefined;
+        partial?: string | undefined;
+    }[] | undefined;
+    tenancy?: {
+        enabled: boolean;
+        strategy: "shared" | "isolated" | "hybrid";
+        tenantField: string;
+        crossTenantAccess: boolean;
+    } | undefined;
+    softDelete?: {
+        enabled: boolean;
+        field: string;
+        cascadeDelete: boolean;
+    } | undefined;
+    versioning?: {
+        enabled: boolean;
+        strategy: "snapshot" | "delta" | "event-sourcing";
+        versionField: string;
+        retentionDays?: number | undefined;
+    } | undefined;
+    partitioning?: {
+        enabled: boolean;
+        strategy: "hash" | "range" | "list";
+        key: string;
+        interval?: string | undefined;
+    } | undefined;
+    cdc?: {
+        enabled: boolean;
+        events: ("update" | "delete" | "insert")[];
+        destination: string;
+    } | undefined;
+    validations?: _objectstack_spec_data.BaseValidationRuleShape[] | undefined;
+    stateMachines?: Record<string, {
+        id: string;
+        initial: string;
+        states: Record<string, StateNodeConfig>;
+        description?: string | undefined;
+        contextSchema?: Record<string, unknown> | undefined;
+        on?: Record<string, string | {
+            target?: string | undefined;
+            cond?: string | {
+                type: string;
+                params?: Record<string, unknown> | undefined;
+            } | undefined;
+            actions?: (string | {
+                type: string;
+                params?: Record<string, unknown> | undefined;
+            })[] | undefined;
+            description?: string | undefined;
+        } | {
+            target?: string | undefined;
+            cond?: string | {
+                type: string;
+                params?: Record<string, unknown> | undefined;
+            } | undefined;
+            actions?: (string | {
+                type: string;
+                params?: Record<string, unknown> | undefined;
+            })[] | undefined;
+            description?: string | undefined;
+        }[]> | undefined;
+    }> | undefined;
+    displayNameField?: string | undefined;
+    recordName?: {
+        type: "text" | "autonumber";
+        displayFormat?: string | undefined;
+        startNumber?: number | undefined;
+    } | undefined;
+    titleFormat?: string | undefined;
+    compactLayout?: string[] | undefined;
+    search?: {
+        fields: string[];
+        displayFields?: string[] | undefined;
+        filters?: string[] | undefined;
+    } | undefined;
+    enable?: {
+        trackHistory: boolean;
+        searchable: boolean;
+        apiEnabled: boolean;
+        files: boolean;
+        feeds: boolean;
+        activities: boolean;
+        trash: boolean;
+        mru: boolean;
+        clone: boolean;
+        apiMethods?: ("search" | "upsert" | "list" | "update" | "delete" | "history" | "get" | "create" | "bulk" | "aggregate" | "restore" | "purge" | "import" | "export")[] | undefined;
+    } | undefined;
+    recordTypes?: string[] | undefined;
+    sharingModel?: "private" | "full" | "read" | "read_write" | undefined;
+    keyPrefix?: string | undefined;
+    actions?: {
+        name: string;
+        label: string | {
+            key: string;
+            defaultValue?: string | undefined;
+            params?: Record<string, string | number | boolean> | undefined;
+        };
+        type: "url" | "script" | "modal" | "flow" | "api";
+        refreshAfter: boolean;
+        objectName?: string | undefined;
+        icon?: string | undefined;
+        locations?: ("list_toolbar" | "list_item" | "record_header" | "record_more" | "record_related" | "global_nav")[] | undefined;
+        component?: "action:button" | "action:icon" | "action:menu" | "action:group" | undefined;
+        target?: string | undefined;
+        execute?: string | undefined;
+        params?: {
+            name: string;
+            label: string | {
+                key: string;
+                defaultValue?: string | undefined;
+                params?: Record<string, string | number | boolean> | undefined;
+            };
+            type: "number" | "boolean" | "date" | "lookup" | "file" | "url" | "json" | "text" | "textarea" | "email" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
+            required: boolean;
+            options?: {
+                label: string | {
+                    key: string;
+                    defaultValue?: string | undefined;
+                    params?: Record<string, string | number | boolean> | undefined;
+                };
+                value: string;
+            }[] | undefined;
+        }[] | undefined;
+        variant?: "link" | "primary" | "secondary" | "danger" | "ghost" | undefined;
+        confirmText?: string | {
+            key: string;
+            defaultValue?: string | undefined;
+            params?: Record<string, string | number | boolean> | undefined;
+        } | undefined;
+        successMessage?: string | {
+            key: string;
+            defaultValue?: string | undefined;
+            params?: Record<string, string | number | boolean> | undefined;
+        } | undefined;
+        visible?: string | undefined;
+        disabled?: string | boolean | undefined;
+        shortcut?: string | undefined;
+        bulkEnabled?: boolean | undefined;
+        timeout?: number | undefined;
+        aria?: {
+            ariaLabel?: string | {
+                key: string;
+                defaultValue?: string | undefined;
+                params?: Record<string, string | number | boolean> | undefined;
+            } | undefined;
+            ariaDescribedBy?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+}, "fields"> & Pick<{
+    readonly namespace: "ai";
+    readonly name: "messages";
+    readonly label: "AI Message";
+    readonly pluralLabel: "AI Messages";
+    readonly icon: "message-circle";
+    readonly isSystem: true;
+    readonly description: "Individual messages within AI conversations";
+    readonly fields: {
+        readonly id: {
+            readonly format?: string | undefined;
+            readonly expression?: string | undefined;
+            readonly readonly?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly name?: string | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "record" | "field" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly label?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly description?: string | undefined;
+            readonly columnName?: string | undefined;
+            readonly required?: boolean | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly theme?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "hnsw" | "ivfflat" | "flat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly group?: string | undefined;
+            readonly conditionalRequired?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly type: "text";
+        };
+        readonly conversation_id: {
+            readonly format?: string | undefined;
+            readonly expression?: string | undefined;
+            readonly readonly?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly name?: string | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "record" | "field" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly label?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly description?: string | undefined;
+            readonly columnName?: string | undefined;
+            readonly required?: boolean | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly theme?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "hnsw" | "ivfflat" | "flat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly group?: string | undefined;
+            readonly conditionalRequired?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly type: "text";
+        };
+        readonly role: {
+            readonly format?: string | undefined;
+            readonly expression?: string | undefined;
+            readonly readonly?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly name?: string | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "record" | "field" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly label?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly description?: string | undefined;
+            readonly columnName?: string | undefined;
+            readonly required?: boolean | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            options: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[];
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly theme?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "hnsw" | "ivfflat" | "flat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly group?: string | undefined;
+            readonly conditionalRequired?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly type: "select";
+        };
+        readonly content: {
+            readonly format?: string | undefined;
+            readonly expression?: string | undefined;
+            readonly readonly?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly name?: string | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "record" | "field" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly label?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly description?: string | undefined;
+            readonly columnName?: string | undefined;
+            readonly required?: boolean | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly theme?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "hnsw" | "ivfflat" | "flat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly group?: string | undefined;
+            readonly conditionalRequired?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly type: "textarea";
+        };
+        readonly tool_calls: {
+            readonly format?: string | undefined;
+            readonly expression?: string | undefined;
+            readonly readonly?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly name?: string | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "record" | "field" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly label?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly description?: string | undefined;
+            readonly columnName?: string | undefined;
+            readonly required?: boolean | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly theme?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "hnsw" | "ivfflat" | "flat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly group?: string | undefined;
+            readonly conditionalRequired?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly type: "textarea";
+        };
+        readonly tool_call_id: {
+            readonly format?: string | undefined;
+            readonly expression?: string | undefined;
+            readonly readonly?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly name?: string | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "record" | "field" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly label?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly description?: string | undefined;
+            readonly columnName?: string | undefined;
+            readonly required?: boolean | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly theme?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "hnsw" | "ivfflat" | "flat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly group?: string | undefined;
+            readonly conditionalRequired?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly type: "text";
+        };
+        readonly created_at: {
+            readonly format?: string | undefined;
+            readonly expression?: string | undefined;
+            readonly readonly?: boolean | undefined;
+            readonly defaultValue?: unknown;
+            readonly min?: number | undefined;
+            readonly max?: number | undefined;
+            readonly name?: string | undefined;
+            readonly encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "record" | "field" | "database";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            readonly label?: string | undefined;
+            readonly precision?: number | undefined;
+            readonly description?: string | undefined;
+            readonly columnName?: string | undefined;
+            readonly required?: boolean | undefined;
+            readonly searchable?: boolean | undefined;
+            readonly multiple?: boolean | undefined;
+            readonly unique?: boolean | undefined;
+            readonly maxLength?: number | undefined;
+            readonly minLength?: number | undefined;
+            readonly scale?: number | undefined;
+            readonly options?: {
+                label: string;
+                value: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            readonly reference?: string | undefined;
+            readonly referenceFilters?: string[] | undefined;
+            readonly writeRequiresMasterRead?: boolean | undefined;
+            readonly deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+            readonly summaryOperations?: {
+                object: string;
+                field: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
+            } | undefined;
+            readonly language?: string | undefined;
+            readonly theme?: string | undefined;
+            readonly lineNumbers?: boolean | undefined;
+            readonly maxRating?: number | undefined;
+            readonly allowHalf?: boolean | undefined;
+            readonly displayMap?: boolean | undefined;
+            readonly allowGeocoding?: boolean | undefined;
+            readonly addressFormat?: "us" | "uk" | "international" | undefined;
+            readonly colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+            readonly allowAlpha?: boolean | undefined;
+            readonly presetColors?: string[] | undefined;
+            readonly step?: number | undefined;
+            readonly showValue?: boolean | undefined;
+            readonly marks?: Record<string, string> | undefined;
+            readonly barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+            readonly qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+            readonly displayValue?: boolean | undefined;
+            readonly allowScanning?: boolean | undefined;
+            readonly currencyConfig?: {
+                precision: number;
+                currencyMode: "dynamic" | "fixed";
+                defaultCurrency: string;
+            } | undefined;
+            readonly vectorConfig?: {
+                dimensions: number;
+                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+                normalized: boolean;
+                indexed: boolean;
+                indexType?: "hnsw" | "ivfflat" | "flat" | undefined;
+            } | undefined;
+            readonly fileAttachmentConfig?: {
+                virusScan: boolean;
+                virusScanOnUpload: boolean;
+                quarantineOnThreat: boolean;
+                allowMultiple: boolean;
+                allowReplace: boolean;
+                allowDelete: boolean;
+                requireUpload: boolean;
+                extractMetadata: boolean;
+                extractText: boolean;
+                versioningEnabled: boolean;
+                publicRead: boolean;
+                presignedUrlExpiry: number;
+                minSize?: number | undefined;
+                maxSize?: number | undefined;
+                allowedTypes?: string[] | undefined;
+                blockedTypes?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                blockedMimeTypes?: string[] | undefined;
+                virusScanProvider?: "custom" | "clamav" | "virustotal" | "metadefender" | undefined;
+                storageProvider?: string | undefined;
+                storageBucket?: string | undefined;
+                storagePrefix?: string | undefined;
+                imageValidation?: {
+                    generateThumbnails: boolean;
+                    preserveMetadata: boolean;
+                    autoRotate: boolean;
+                    minWidth?: number | undefined;
+                    maxWidth?: number | undefined;
+                    minHeight?: number | undefined;
+                    maxHeight?: number | undefined;
+                    aspectRatio?: string | undefined;
+                    thumbnailSizes?: {
+                        name: string;
+                        width: number;
+                        height: number;
+                        crop: boolean;
+                    }[] | undefined;
+                } | undefined;
+                maxVersions?: number | undefined;
+            } | undefined;
+            readonly maskingRule?: {
+                field: string;
+                strategy: "redact" | "partial" | "hash" | "tokenize" | "randomize" | "nullify" | "substitute";
+                preserveFormat: boolean;
+                preserveLength: boolean;
+                pattern?: string | undefined;
+                roles?: string[] | undefined;
+                exemptRoles?: string[] | undefined;
+            } | undefined;
+            readonly auditTrail?: boolean | undefined;
+            readonly dependencies?: string[] | undefined;
+            readonly cached?: {
+                enabled: boolean;
+                ttl: number;
+                invalidateOn: string[];
+            } | undefined;
+            readonly dataQuality?: {
+                uniqueness: boolean;
+                completeness: number;
+                accuracy?: {
+                    source: string;
+                    threshold: number;
+                } | undefined;
+            } | undefined;
+            readonly group?: string | undefined;
+            readonly conditionalRequired?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly sortable?: boolean | undefined;
+            readonly inlineHelpText?: string | undefined;
+            readonly trackFeedHistory?: boolean | undefined;
+            readonly caseSensitive?: boolean | undefined;
+            readonly autonumberFormat?: string | undefined;
+            readonly index?: boolean | undefined;
+            readonly externalId?: boolean | undefined;
+            readonly type: "datetime";
+        };
+    };
+    readonly indexes: [{
+        readonly fields: ["conversation_id"];
+    }, {
+        readonly fields: ["conversation_id", "created_at"];
+    }];
+    readonly enable: {
+        readonly trackHistory: false;
+        readonly searchable: false;
+        readonly apiEnabled: true;
+        readonly apiMethods: ["get", "list", "create"];
+        readonly trash: false;
+        readonly mru: false;
+    };
+}, "fields">;
+
+/**
+ * Minimal HTTP handler abstraction so routes stay framework-agnostic.
+ *
+ * Consumers wire these handlers to their HTTP server of choice
+ * (Hono, Express, Fastify, etc.) via the kernel's HTTP server service.
+ */
+interface RouteDefinition {
+    /** HTTP method */
+    method: 'GET' | 'POST' | 'DELETE';
+    /** Path pattern (e.g. '/api/v1/ai/chat') */
+    path: string;
+    /** Human-readable description */
+    description: string;
+    /**
+     * Handler receives a plain request-like object and returns a response-like
+     * object.  SSE responses set `stream: true` and provide an async iterable.
+     */
+    handler: (req: RouteRequest) => Promise<RouteResponse>;
+}
+interface RouteRequest {
+    /** Parsed JSON body (for POST requests) */
+    body?: unknown;
+    /** Route/query parameters */
+    params?: Record<string, string>;
+    /** Query string parameters */
+    query?: Record<string, string>;
+}
+interface RouteResponse {
+    /** HTTP status code */
+    status: number;
+    /** JSON-serializable body (for non-streaming responses) */
+    body?: unknown;
+    /** If true, `stream` provides SSE events */
+    stream?: boolean;
+    /** Async iterable of SSE events (when stream=true) */
+    events?: AsyncIterable<unknown>;
+}
+/**
+ * Build the standard AI REST/SSE routes.
+ *
+ * Depends on contracts ({@link IAIService} + {@link IAIConversationService})
+ * rather than concrete implementations, so any compliant service pair can
+ * be wired in.
+ *
+ * Routes:
+ * | Method | Path | Description |
+ * |:---|:---|:---|
+ * | POST | /api/v1/ai/chat | Synchronous chat completion |
+ * | POST | /api/v1/ai/chat/stream | SSE streaming chat completion |
+ * | POST | /api/v1/ai/complete | Text completion |
+ * | GET  | /api/v1/ai/models | List available models |
+ * | POST | /api/v1/ai/conversations | Create a conversation |
+ * | GET  | /api/v1/ai/conversations | List conversations |
+ * | POST | /api/v1/ai/conversations/:id/messages | Add message to conversation |
+ * | DELETE | /api/v1/ai/conversations/:id | Delete conversation |
+ */
+declare function buildAIRoutes(aiService: IAIService, conversationService: IAIConversationService, logger: Logger): RouteDefinition[];
+
+/**
+ * Build agent-specific REST routes.
+ *
+ * | Method | Path | Description |
+ * |:---|:---|:---|
+ * | POST | /api/v1/ai/agents/:agentName/chat | Chat with a specific agent |
+ */
+declare function buildAgentRoutes(aiService: AIService, agentRuntime: AgentRuntime, logger: Logger): RouteDefinition[];
+
+export { AIService, type AIServiceConfig, AIServicePlugin, type AIServicePluginOptions, type AgentChatContext, AgentRuntime, AiConversationObject, AiMessageObject, DATA_CHAT_AGENT, DATA_TOOL_DEFINITIONS, type DataToolContext, InMemoryConversationService, MemoryLLMAdapter, ObjectQLConversationService, type RouteDefinition, type RouteRequest, type RouteResponse, type ToolHandler, ToolRegistry, buildAIRoutes, buildAgentRoutes, registerDataTools };