@objectstack/service-ai 6.0.0 → 6.1.1

package/dist/index.d.cts

@@ -7,6 +7,7 @@ import { Plugin, PluginContext } from '@objectstack/core';
 import { LanguageModelV2 } from '@ai-sdk/provider';
 import { TextStreamPart as TextStreamPart$1, ToolSet as ToolSet$1 } from 'ai';
 import { InstalledPackage } from '@objectstack/spec/kernel';
+import { Action } from '@objectstack/spec/ui';
 import * as _objectstack_spec_data from '@objectstack/spec/data';
 
 /**
@@ -325,6 +326,7 @@ declare class AIService implements IAIService {
      *    maximum number of iterations (`maxIterations`) is reached.
      */
     chatWithTools(messages: ModelMessage[], options?: ChatWithToolsOptions): Promise<AIResult>;
+    private chatWithToolsImpl;
     /**
      * Stream chat with automatic tool call resolution.
      *
@@ -937,6 +939,102 @@ interface PackageToolContext {
  */
 declare function registerPackageTools(registry: ToolRegistry, context: PackageToolContext): void;
 
+/**
+ * Actions-as-Tools — turn declarative {@link Action} metadata into
+ * AI-callable tools so an agent can not only **read** the user's data
+ * (via `query_data` / `data_explorer`) but also **act** on it.
+ *
+ * Phase 1 scope (this module):
+ *   - Only `type: 'script'` actions are auto-exposed. Their handler is
+ *     resolved through {@link IDataEngine.executeAction} (the same
+ *     dispatcher used by Studio's "row toolbar" buttons), so the LLM
+ *     ends up calling exactly the same business logic the UI does.
+ *   - Skip any action that is dangerous (`confirmText`, `variant: 'danger'`,
+ *     `mode: 'delete'`) — these require Phase 2 HITL plumbing.
+ *   - Skip any action whose owner opted out via `aiExposed: false` (the
+ *     hint is read from the action record but not formalised in the Zod
+ *     schema yet; spec change is backwards-compatible additive).
+ *
+ * The tool's JSON Schema is materialised from `action.params[]`,
+ * resolving field-backed params (`{ field: 'priority' }`) against the
+ * owning object so the LLM sees the same type/options/required
+ * constraints the modal dialog would render.
+ */
+
+/** Minimal field shape we care about when resolving param types. */
+interface FieldDef {
+    type?: string;
+    label?: string;
+    required?: boolean;
+    options?: Array<{
+        value: string;
+        label?: unknown;
+    } | string>;
+    description?: string;
+}
+/** Minimal object shape — same as what {@link SchemaRetriever} consumes. */
+interface ObjectDef {
+    name: string;
+    label?: string;
+    pluralLabel?: string;
+    fields?: Record<string, FieldDef>;
+    actions?: Action[];
+}
+/**
+ * Dependencies needed to invoke an Action from the AI tool runtime.
+ *
+ * The `metadata` service is used at registration time to resolve param
+ * field types; the `dataEngine` is used at call time to (a) load the
+ * subject record when a `recordIdParam` is configured and (b) dispatch
+ * to the registered handler via `executeAction`.
+ *
+ * `principal` lets callers attribute AI-initiated mutations to a known
+ * user id; it defaults to a synthetic `'ai_agent'` user so traces /
+ * audit always have *some* actor.
+ */
+interface ActionToolsContext {
+    metadata: IMetadataService;
+    dataEngine: IDataEngine;
+    /** Synthetic user attribution for AI-initiated calls. */
+    principal?: {
+        id: string;
+        name?: string;
+    };
+    /** Tool-name prefix (default: `action_`). Keeps namespace separate from data tools. */
+    toolPrefix?: string;
+}
+/**
+ * Decide whether an action should be auto-exposed as a tool.
+ *
+ * Returns `null` when exposed, or a string reason when skipped.
+ * Exported for tests and Studio "AI exposure" diagnostics.
+ */
+declare function actionSkipReason(action: Action): string | null;
+/** Compute the AI tool name for a given action (prefixed for namespacing). */
+declare function actionToolName(action: Action, prefix?: string): string;
+/**
+ * Convert a single {@link Action} into a complete {@link AIToolDefinition}.
+ *
+ * Returns `null` when the action is filtered out by {@link actionSkipReason}.
+ */
+declare function actionToToolDefinition(action: Action, ownerObject: ObjectDef | undefined, allObjects: Map<string, ObjectDef>, toolPrefix?: string): AIToolDefinition | null;
+/**
+ * Walk every registered object in the {@link IMetadataService}, pick out
+ * each object's actions, and register the ones that pass {@link actionSkipReason}
+ * as AI tools.
+ *
+ * Returns the list of registered tool names and a parallel list of
+ * `{ action, reason }` for actions that were intentionally skipped —
+ * useful for Studio's "AI exposure" diagnostics surface.
+ */
+declare function registerActionsAsTools(registry: ToolRegistry, context: ActionToolsContext): Promise<{
+    registered: string[];
+    skipped: Array<{
+        action: string;
+        reason: string;
+    }>;
+}>;
+
 /**
  * Runtime context passed when chatting with the ambient assistant.
  *
@@ -1229,6 +1327,58 @@ declare const DATA_CHAT_AGENT: Agent;
  */
 declare const METADATA_ASSISTANT_AGENT: Agent;
 
+/**
+ * Built-in `data_explorer` skill — the read-only data-Q&A capability
+ * bundle that the `data_chat` agent (and any other agent that wants
+ * data-exploration powers) attaches to its `skills[]`.
+ *
+ * Following the platform's metadata-driven philosophy, the agent
+ * itself no longer hardcodes which tools it can call; instead it
+ * names this skill and the SkillRegistry resolves the tool list at
+ * request time. Disabling this skill via the metadata service
+ * disables data exploration for every agent that references it,
+ * without code changes.
+ */
+declare const DATA_EXPLORER_SKILL: Skill;
+
+/**
+ * Built-in `metadata_authoring` skill — the write-side schema-design
+ * capability bundle attached to the `metadata_assistant` agent (and
+ * any other agent that should be allowed to mutate schema).
+ *
+ * Splitting this off from the agent record lets us:
+ * - Reuse the same authoring tools across multiple agent personas
+ *   (e.g. an "ops bot" that ALSO can author).
+ * - Disable authoring globally by setting `active: false` on the
+ *   skill metadata, without redeploying the agent.
+ * - Layer permissions via `Skill.permissions` independent of the
+ *   agent's permissions.
+ */
+declare const METADATA_AUTHORING_SKILL: Skill;
+
+/**
+ * Built-in `actions_executor` skill — the write-side counterpart to
+ * `data_explorer`.
+ *
+ * Where `data_explorer` lets an agent **answer** questions about the
+ * user's data, `actions_executor` lets the same agent **perform**
+ * business operations: complete tasks, start workflows, send invites,
+ * etc. The concrete tools are not enumerated here — they're materialised
+ * at runtime from every `Action` declared on every object the metadata
+ * service knows about (see `registerActionsAsTools` in
+ * `tools/action-tools.ts`). The skill records the *intent* ("agent may
+ * invoke business actions"); the registry expands it into actual tools
+ * after metadata is loaded.
+ *
+ * The `tools` array is intentionally empty — Phase 1 lets the
+ * skill-registry resolver fall through to the global tool list when an
+ * agent's skill bundle would otherwise filter out the dynamically
+ * registered `action_*` tools. Skills that want to restrict the set
+ * should be authored project-side with the specific `action_<name>`
+ * tools they want to expose.
+ */
+declare const ACTIONS_EXECUTOR_SKILL: Skill;
+
 declare const ActionRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
     type: z.ZodString;
     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1855,7 +2005,7 @@ declare const AiConversationObject: Omit<{
         trash: boolean;
         mru: boolean;
         clone: boolean;
-        apiMethods?: ("search" | "upsert" | "create" | "import" | "delete" | "list" | "get" | "update" | "history" | "bulk" | "aggregate" | "restore" | "purge" | "export")[] | undefined;
+        apiMethods?: ("restore" | "export" | "import" | "search" | "upsert" | "create" | "delete" | "list" | "get" | "update" | "history" | "bulk" | "aggregate" | "purge")[] | undefined;
     } | undefined;
     recordTypes?: string[] | undefined;
     sharingModel?: "private" | "read" | "full" | "read_write" | undefined;
@@ -1926,6 +2076,7 @@ declare const AiConversationObject: Omit<{
         } | undefined;
         shortcut?: string | undefined;
         bulkEnabled?: boolean | undefined;
+        aiExposed?: boolean | undefined;
         recordIdParam?: string | undefined;
         recordIdField?: string | undefined;
         bodyShape?: "flat" | {
@@ -3779,7 +3930,7 @@ declare const AiMessageObject: Omit<{
         trash: boolean;
         mru: boolean;
         clone: boolean;
-        apiMethods?: ("search" | "upsert" | "create" | "import" | "delete" | "list" | "get" | "update" | "history" | "bulk" | "aggregate" | "restore" | "purge" | "export")[] | undefined;
+        apiMethods?: ("restore" | "export" | "import" | "search" | "upsert" | "create" | "delete" | "list" | "get" | "update" | "history" | "bulk" | "aggregate" | "purge")[] | undefined;
     } | undefined;
     recordTypes?: string[] | undefined;
     sharingModel?: "private" | "read" | "full" | "read_write" | undefined;
@@ -3850,6 +4001,7 @@ declare const AiMessageObject: Omit<{
         } | undefined;
         shortcut?: string | undefined;
         bulkEnabled?: boolean | undefined;
+        aiExposed?: boolean | undefined;
         recordIdParam?: string | undefined;
         recordIdField?: string | undefined;
         bodyShape?: "flat" | {
@@ -5705,7 +5857,7 @@ declare const AiTraceObject: Omit<{
         trash: boolean;
         mru: boolean;
         clone: boolean;
-        apiMethods?: ("search" | "upsert" | "create" | "import" | "delete" | "list" | "get" | "update" | "history" | "bulk" | "aggregate" | "restore" | "purge" | "export")[] | undefined;
+        apiMethods?: ("restore" | "export" | "import" | "search" | "upsert" | "create" | "delete" | "list" | "get" | "update" | "history" | "bulk" | "aggregate" | "purge")[] | undefined;
     } | undefined;
     recordTypes?: string[] | undefined;
     sharingModel?: "private" | "read" | "full" | "read_write" | undefined;
@@ -5776,6 +5928,7 @@ declare const AiTraceObject: Omit<{
         } | undefined;
         shortcut?: string | undefined;
         bulkEnabled?: boolean | undefined;
+        aiExposed?: boolean | undefined;
         recordIdParam?: string | undefined;
         recordIdField?: string | undefined;
         bodyShape?: "flat" | {
@@ -8971,6 +9124,745 @@ declare const AiTraceObject: Omit<{
     };
 }, "fields">;
 
+/**
+ * ai_traces — built-in Studio list view.
+ *
+ * Exposes per-call observability for every LLM invocation that flowed
+ * through the `AIService`. Ships with the platform so users don't have
+ * to author a view for an object they didn't create.
+ *
+ * - Default list: grid sorted by `created_at` desc, showing the columns an
+ *   operator usually wants at a glance (operation, model, latency, tokens,
+ *   cost, status).
+ * - `errors` view: pre-filtered to status="error" for triage.
+ * - `by_model` view: grouped by model for cost / quality comparison.
+ *
+ * Registered via the AIService plugin's manifest payload — appears
+ * automatically in Studio when AIService is loaded.
+ */
+declare const AiTraceView: {
+    list?: {
+        type: "map" | "kanban" | "calendar" | "gantt" | "gallery" | "timeline" | "chart" | "grid";
+        columns: string[] | {
+            field: string;
+            label?: string | undefined;
+            width?: number | undefined;
+            align?: "left" | "center" | "right" | undefined;
+            hidden?: boolean | undefined;
+            sortable?: boolean | undefined;
+            resizable?: boolean | undefined;
+            wrap?: boolean | undefined;
+            type?: string | undefined;
+            pinned?: "left" | "right" | undefined;
+            summary?: "none" | "min" | "max" | "count" | "sum" | "avg" | "count_empty" | "count_filled" | "count_unique" | "percent_empty" | "percent_filled" | undefined;
+            link?: boolean | undefined;
+            action?: string | undefined;
+        }[];
+        name?: string | undefined;
+        label?: string | undefined;
+        data?: {
+            provider: "object";
+            object: string;
+        } | {
+            provider: "api";
+            read?: {
+                url: string;
+                method: "GET" | "POST" | "DELETE" | "PATCH" | "PUT";
+                headers?: Record<string, string> | undefined;
+                params?: Record<string, unknown> | undefined;
+                body?: unknown;
+            } | undefined;
+            write?: {
+                url: string;
+                method: "GET" | "POST" | "DELETE" | "PATCH" | "PUT";
+                headers?: Record<string, string> | undefined;
+                params?: Record<string, unknown> | undefined;
+                body?: unknown;
+            } | undefined;
+        } | {
+            provider: "value";
+            items: unknown[];
+        } | undefined;
+        filter?: {
+            field: string;
+            operator: string;
+            value?: string | number | boolean | (string | number)[] | null | undefined;
+        }[] | undefined;
+        sort?: string | {
+            field: string;
+            order: "asc" | "desc";
+        }[] | undefined;
+        searchableFields?: string[] | undefined;
+        filterableFields?: string[] | undefined;
+        resizable?: boolean | undefined;
+        striped?: boolean | undefined;
+        bordered?: boolean | undefined;
+        compactToolbar?: boolean | undefined;
+        selection?: {
+            type: "none" | "multiple" | "single";
+        } | undefined;
+        navigation?: {
+            mode: "none" | "split" | "page" | "modal" | "drawer" | "popover" | "new_window";
+            preventNavigation: boolean;
+            openNewTab: boolean;
+            view?: string | undefined;
+            width?: string | number | undefined;
+        } | undefined;
+        pagination?: {
+            pageSize: number;
+            pageSizeOptions?: number[] | undefined;
+        } | undefined;
+        kanban?: {
+            groupByField: string;
+            columns: string[];
+            summarizeField?: string | undefined;
+        } | undefined;
+        calendar?: {
+            startDateField: string;
+            titleField: string;
+            endDateField?: string | undefined;
+            colorField?: string | undefined;
+        } | undefined;
+        gantt?: {
+            startDateField: string;
+            endDateField: string;
+            titleField: string;
+            progressField?: string | undefined;
+            dependenciesField?: string | undefined;
+        } | undefined;
+        gallery?: {
+            coverFit: "cover" | "contain";
+            cardSize: "small" | "medium" | "large";
+            coverField?: string | undefined;
+            titleField?: string | undefined;
+            visibleFields?: string[] | undefined;
+        } | undefined;
+        timeline?: {
+            startDateField: string;
+            titleField: string;
+            scale: "day" | "week" | "month" | "quarter" | "year" | "hour";
+            endDateField?: string | undefined;
+            groupByField?: string | undefined;
+            colorField?: string | undefined;
+        } | undefined;
+        chart?: {
+            chartType: "bar" | "line" | "pie" | "area" | "scatter";
+            xAxisField: string;
+            yAxisFields: string[];
+            aggregation?: "min" | "max" | "count" | "sum" | "avg" | undefined;
+            groupByField?: string | undefined;
+        } | undefined;
+        description?: string | undefined;
+        sharing?: {
+            type: "personal" | "collaborative";
+            lockedBy?: string | undefined;
+        } | undefined;
+        rowHeight?: "medium" | "short" | "compact" | "tall" | "extra_tall" | undefined;
+        grouping?: {
+            fields: {
+                field: string;
+                order: "asc" | "desc";
+                collapsed: boolean;
+            }[];
+        } | undefined;
+        rowColor?: {
+            field: string;
+            colors?: Record<string, string> | undefined;
+        } | undefined;
+        hiddenFields?: string[] | undefined;
+        fieldOrder?: string[] | undefined;
+        rowActions?: string[] | undefined;
+        bulkActions?: string[] | undefined;
+        bulkActionDefs?: Record<string, any>[] | undefined;
+        virtualScroll?: boolean | undefined;
+        conditionalFormatting?: {
+            condition: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            };
+            style: Record<string, string>;
+        }[] | undefined;
+        inlineEdit?: boolean | undefined;
+        exportOptions?: ("json" | "csv" | "xlsx" | "pdf")[] | undefined;
+        userActions?: {
+            sort: boolean;
+            search: boolean;
+            filter: boolean;
+            rowHeight: boolean;
+            addRecordForm: boolean;
+            buttons?: string[] | undefined;
+        } | undefined;
+        appearance?: {
+            showDescription: boolean;
+            allowedVisualizations?: ("map" | "kanban" | "calendar" | "gantt" | "gallery" | "timeline" | "grid")[] | undefined;
+        } | undefined;
+        tabs?: {
+            name: string;
+            pinned: boolean;
+            isDefault: boolean;
+            visible: boolean;
+            label?: string | undefined;
+            icon?: string | undefined;
+            view?: string | undefined;
+            filter?: {
+                field: string;
+                operator: string;
+                value?: string | number | boolean | (string | number)[] | null | undefined;
+            }[] | undefined;
+            order?: number | undefined;
+        }[] | undefined;
+        addRecord?: {
+            enabled: boolean;
+            position: "top" | "bottom" | "both";
+            mode: "modal" | "form" | "inline";
+            formView?: string | undefined;
+        } | undefined;
+        showRecordCount?: boolean | undefined;
+        allowPrinting?: boolean | undefined;
+        emptyState?: {
+            title?: string | undefined;
+            message?: string | undefined;
+            icon?: string | undefined;
+        } | undefined;
+        aria?: {
+            ariaLabel?: string | undefined;
+            ariaDescribedBy?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+        responsive?: {
+            breakpoint?: "md" | "xs" | "sm" | "lg" | "xl" | "2xl" | undefined;
+            hiddenOn?: ("md" | "xs" | "sm" | "lg" | "xl" | "2xl")[] | undefined;
+            columns?: {
+                xs?: number | undefined;
+                sm?: number | undefined;
+                md?: number | undefined;
+                lg?: number | undefined;
+                xl?: number | undefined;
+                '2xl'?: number | undefined;
+            } | undefined;
+            order?: {
+                xs?: number | undefined;
+                sm?: number | undefined;
+                md?: number | undefined;
+                lg?: number | undefined;
+                xl?: number | undefined;
+                '2xl'?: number | undefined;
+            } | undefined;
+        } | undefined;
+        performance?: {
+            lazyLoad?: boolean | undefined;
+            virtualScroll?: {
+                enabled: boolean;
+                itemHeight?: number | undefined;
+                overscan?: number | undefined;
+            } | undefined;
+            cacheStrategy?: "none" | "cache-first" | "network-first" | "stale-while-revalidate" | undefined;
+            prefetch?: boolean | undefined;
+            pageSize?: number | undefined;
+            debounceMs?: number | undefined;
+        } | undefined;
+    } | undefined;
+    form?: {
+        type: "split" | "modal" | "drawer" | "simple" | "tabbed" | "wizard";
+        data?: {
+            provider: "object";
+            object: string;
+        } | {
+            provider: "api";
+            read?: {
+                url: string;
+                method: "GET" | "POST" | "DELETE" | "PATCH" | "PUT";
+                headers?: Record<string, string> | undefined;
+                params?: Record<string, unknown> | undefined;
+                body?: unknown;
+            } | undefined;
+            write?: {
+                url: string;
+                method: "GET" | "POST" | "DELETE" | "PATCH" | "PUT";
+                headers?: Record<string, string> | undefined;
+                params?: Record<string, unknown> | undefined;
+                body?: unknown;
+            } | undefined;
+        } | {
+            provider: "value";
+            items: unknown[];
+        } | undefined;
+        sections?: {
+            collapsible: boolean;
+            collapsed: boolean;
+            columns: 1 | 2 | 3 | 4;
+            fields: (string | {
+                field: string;
+                label?: string | undefined;
+                placeholder?: string | undefined;
+                helpText?: string | undefined;
+                readonly?: boolean | undefined;
+                required?: boolean | undefined;
+                hidden?: boolean | undefined;
+                colSpan?: number | undefined;
+                widget?: string | undefined;
+                dependsOn?: string | undefined;
+                visibleOn?: {
+                    dialect: "cel" | "js" | "cron" | "template";
+                    source?: string | undefined;
+                    ast?: unknown;
+                    meta?: {
+                        rationale?: string | undefined;
+                        generatedBy?: string | undefined;
+                    } | undefined;
+                } | {
+                    dialect: "cel" | "js" | "cron" | "template";
+                    source?: string | undefined;
+                    ast?: unknown;
+                    meta?: {
+                        rationale?: string | undefined;
+                        generatedBy?: string | undefined;
+                    } | undefined;
+                } | undefined;
+            })[];
+            label?: string | undefined;
+        }[] | undefined;
+        groups?: {
+            collapsible: boolean;
+            collapsed: boolean;
+            columns: 1 | 2 | 3 | 4;
+            fields: (string | {
+                field: string;
+                label?: string | undefined;
+                placeholder?: string | undefined;
+                helpText?: string | undefined;
+                readonly?: boolean | undefined;
+                required?: boolean | undefined;
+                hidden?: boolean | undefined;
+                colSpan?: number | undefined;
+                widget?: string | undefined;
+                dependsOn?: string | undefined;
+                visibleOn?: {
+                    dialect: "cel" | "js" | "cron" | "template";
+                    source?: string | undefined;
+                    ast?: unknown;
+                    meta?: {
+                        rationale?: string | undefined;
+                        generatedBy?: string | undefined;
+                    } | undefined;
+                } | {
+                    dialect: "cel" | "js" | "cron" | "template";
+                    source?: string | undefined;
+                    ast?: unknown;
+                    meta?: {
+                        rationale?: string | undefined;
+                        generatedBy?: string | undefined;
+                    } | undefined;
+                } | undefined;
+            })[];
+            label?: string | undefined;
+        }[] | undefined;
+        defaultSort?: {
+            field: string;
+            order: "asc" | "desc";
+        }[] | undefined;
+        sharing?: {
+            enabled: boolean;
+            allowAnonymous: boolean;
+            publicLink?: string | undefined;
+            password?: string | undefined;
+            allowedDomains?: string[] | undefined;
+            expiresAt?: string | undefined;
+        } | undefined;
+        submitBehavior?: {
+            kind: "thank-you";
+            title?: string | undefined;
+            message?: string | undefined;
+        } | {
+            kind: "redirect";
+            url: string;
+            delayMs?: number | undefined;
+        } | {
+            kind: "continue";
+        } | {
+            kind: "next-record";
+        } | undefined;
+        aria?: {
+            ariaLabel?: string | undefined;
+            ariaDescribedBy?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+    } | undefined;
+    listViews?: Record<string, {
+        type: "map" | "kanban" | "calendar" | "gantt" | "gallery" | "timeline" | "chart" | "grid";
+        columns: string[] | {
+            field: string;
+            label?: string | undefined;
+            width?: number | undefined;
+            align?: "left" | "center" | "right" | undefined;
+            hidden?: boolean | undefined;
+            sortable?: boolean | undefined;
+            resizable?: boolean | undefined;
+            wrap?: boolean | undefined;
+            type?: string | undefined;
+            pinned?: "left" | "right" | undefined;
+            summary?: "none" | "min" | "max" | "count" | "sum" | "avg" | "count_empty" | "count_filled" | "count_unique" | "percent_empty" | "percent_filled" | undefined;
+            link?: boolean | undefined;
+            action?: string | undefined;
+        }[];
+        name?: string | undefined;
+        label?: string | undefined;
+        data?: {
+            provider: "object";
+            object: string;
+        } | {
+            provider: "api";
+            read?: {
+                url: string;
+                method: "GET" | "POST" | "DELETE" | "PATCH" | "PUT";
+                headers?: Record<string, string> | undefined;
+                params?: Record<string, unknown> | undefined;
+                body?: unknown;
+            } | undefined;
+            write?: {
+                url: string;
+                method: "GET" | "POST" | "DELETE" | "PATCH" | "PUT";
+                headers?: Record<string, string> | undefined;
+                params?: Record<string, unknown> | undefined;
+                body?: unknown;
+            } | undefined;
+        } | {
+            provider: "value";
+            items: unknown[];
+        } | undefined;
+        filter?: {
+            field: string;
+            operator: string;
+            value?: string | number | boolean | (string | number)[] | null | undefined;
+        }[] | undefined;
+        sort?: string | {
+            field: string;
+            order: "asc" | "desc";
+        }[] | undefined;
+        searchableFields?: string[] | undefined;
+        filterableFields?: string[] | undefined;
+        resizable?: boolean | undefined;
+        striped?: boolean | undefined;
+        bordered?: boolean | undefined;
+        compactToolbar?: boolean | undefined;
+        selection?: {
+            type: "none" | "multiple" | "single";
+        } | undefined;
+        navigation?: {
+            mode: "none" | "split" | "page" | "modal" | "drawer" | "popover" | "new_window";
+            preventNavigation: boolean;
+            openNewTab: boolean;
+            view?: string | undefined;
+            width?: string | number | undefined;
+        } | undefined;
+        pagination?: {
+            pageSize: number;
+            pageSizeOptions?: number[] | undefined;
+        } | undefined;
+        kanban?: {
+            groupByField: string;
+            columns: string[];
+            summarizeField?: string | undefined;
+        } | undefined;
+        calendar?: {
+            startDateField: string;
+            titleField: string;
+            endDateField?: string | undefined;
+            colorField?: string | undefined;
+        } | undefined;
+        gantt?: {
+            startDateField: string;
+            endDateField: string;
+            titleField: string;
+            progressField?: string | undefined;
+            dependenciesField?: string | undefined;
+        } | undefined;
+        gallery?: {
+            coverFit: "cover" | "contain";
+            cardSize: "small" | "medium" | "large";
+            coverField?: string | undefined;
+            titleField?: string | undefined;
+            visibleFields?: string[] | undefined;
+        } | undefined;
+        timeline?: {
+            startDateField: string;
+            titleField: string;
+            scale: "day" | "week" | "month" | "quarter" | "year" | "hour";
+            endDateField?: string | undefined;
+            groupByField?: string | undefined;
+            colorField?: string | undefined;
+        } | undefined;
+        chart?: {
+            chartType: "bar" | "line" | "pie" | "area" | "scatter";
+            xAxisField: string;
+            yAxisFields: string[];
+            aggregation?: "min" | "max" | "count" | "sum" | "avg" | undefined;
+            groupByField?: string | undefined;
+        } | undefined;
+        description?: string | undefined;
+        sharing?: {
+            type: "personal" | "collaborative";
+            lockedBy?: string | undefined;
+        } | undefined;
+        rowHeight?: "medium" | "short" | "compact" | "tall" | "extra_tall" | undefined;
+        grouping?: {
+            fields: {
+                field: string;
+                order: "asc" | "desc";
+                collapsed: boolean;
+            }[];
+        } | undefined;
+        rowColor?: {
+            field: string;
+            colors?: Record<string, string> | undefined;
+        } | undefined;
+        hiddenFields?: string[] | undefined;
+        fieldOrder?: string[] | undefined;
+        rowActions?: string[] | undefined;
+        bulkActions?: string[] | undefined;
+        bulkActionDefs?: Record<string, any>[] | undefined;
+        virtualScroll?: boolean | undefined;
+        conditionalFormatting?: {
+            condition: {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            } | {
+                dialect: "cel" | "js" | "cron" | "template";
+                source?: string | undefined;
+                ast?: unknown;
+                meta?: {
+                    rationale?: string | undefined;
+                    generatedBy?: string | undefined;
+                } | undefined;
+            };
+            style: Record<string, string>;
+        }[] | undefined;
+        inlineEdit?: boolean | undefined;
+        exportOptions?: ("json" | "csv" | "xlsx" | "pdf")[] | undefined;
+        userActions?: {
+            sort: boolean;
+            search: boolean;
+            filter: boolean;
+            rowHeight: boolean;
+            addRecordForm: boolean;
+            buttons?: string[] | undefined;
+        } | undefined;
+        appearance?: {
+            showDescription: boolean;
+            allowedVisualizations?: ("map" | "kanban" | "calendar" | "gantt" | "gallery" | "timeline" | "grid")[] | undefined;
+        } | undefined;
+        tabs?: {
+            name: string;
+            pinned: boolean;
+            isDefault: boolean;
+            visible: boolean;
+            label?: string | undefined;
+            icon?: string | undefined;
+            view?: string | undefined;
+            filter?: {
+                field: string;
+                operator: string;
+                value?: string | number | boolean | (string | number)[] | null | undefined;
+            }[] | undefined;
+            order?: number | undefined;
+        }[] | undefined;
+        addRecord?: {
+            enabled: boolean;
+            position: "top" | "bottom" | "both";
+            mode: "modal" | "form" | "inline";
+            formView?: string | undefined;
+        } | undefined;
+        showRecordCount?: boolean | undefined;
+        allowPrinting?: boolean | undefined;
+        emptyState?: {
+            title?: string | undefined;
+            message?: string | undefined;
+            icon?: string | undefined;
+        } | undefined;
+        aria?: {
+            ariaLabel?: string | undefined;
+            ariaDescribedBy?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+        responsive?: {
+            breakpoint?: "md" | "xs" | "sm" | "lg" | "xl" | "2xl" | undefined;
+            hiddenOn?: ("md" | "xs" | "sm" | "lg" | "xl" | "2xl")[] | undefined;
+            columns?: {
+                xs?: number | undefined;
+                sm?: number | undefined;
+                md?: number | undefined;
+                lg?: number | undefined;
+                xl?: number | undefined;
+                '2xl'?: number | undefined;
+            } | undefined;
+            order?: {
+                xs?: number | undefined;
+                sm?: number | undefined;
+                md?: number | undefined;
+                lg?: number | undefined;
+                xl?: number | undefined;
+                '2xl'?: number | undefined;
+            } | undefined;
+        } | undefined;
+        performance?: {
+            lazyLoad?: boolean | undefined;
+            virtualScroll?: {
+                enabled: boolean;
+                itemHeight?: number | undefined;
+                overscan?: number | undefined;
+            } | undefined;
+            cacheStrategy?: "none" | "cache-first" | "network-first" | "stale-while-revalidate" | undefined;
+            prefetch?: boolean | undefined;
+            pageSize?: number | undefined;
+            debounceMs?: number | undefined;
+        } | undefined;
+    }> | undefined;
+    formViews?: Record<string, {
+        type: "split" | "modal" | "drawer" | "simple" | "tabbed" | "wizard";
+        data?: {
+            provider: "object";
+            object: string;
+        } | {
+            provider: "api";
+            read?: {
+                url: string;
+                method: "GET" | "POST" | "DELETE" | "PATCH" | "PUT";
+                headers?: Record<string, string> | undefined;
+                params?: Record<string, unknown> | undefined;
+                body?: unknown;
+            } | undefined;
+            write?: {
+                url: string;
+                method: "GET" | "POST" | "DELETE" | "PATCH" | "PUT";
+                headers?: Record<string, string> | undefined;
+                params?: Record<string, unknown> | undefined;
+                body?: unknown;
+            } | undefined;
+        } | {
+            provider: "value";
+            items: unknown[];
+        } | undefined;
+        sections?: {
+            collapsible: boolean;
+            collapsed: boolean;
+            columns: 1 | 2 | 3 | 4;
+            fields: (string | {
+                field: string;
+                label?: string | undefined;
+                placeholder?: string | undefined;
+                helpText?: string | undefined;
+                readonly?: boolean | undefined;
+                required?: boolean | undefined;
+                hidden?: boolean | undefined;
+                colSpan?: number | undefined;
+                widget?: string | undefined;
+                dependsOn?: string | undefined;
+                visibleOn?: {
+                    dialect: "cel" | "js" | "cron" | "template";
+                    source?: string | undefined;
+                    ast?: unknown;
+                    meta?: {
+                        rationale?: string | undefined;
+                        generatedBy?: string | undefined;
+                    } | undefined;
+                } | {
+                    dialect: "cel" | "js" | "cron" | "template";
+                    source?: string | undefined;
+                    ast?: unknown;
+                    meta?: {
+                        rationale?: string | undefined;
+                        generatedBy?: string | undefined;
+                    } | undefined;
+                } | undefined;
+            })[];
+            label?: string | undefined;
+        }[] | undefined;
+        groups?: {
+            collapsible: boolean;
+            collapsed: boolean;
+            columns: 1 | 2 | 3 | 4;
+            fields: (string | {
+                field: string;
+                label?: string | undefined;
+                placeholder?: string | undefined;
+                helpText?: string | undefined;
+                readonly?: boolean | undefined;
+                required?: boolean | undefined;
+                hidden?: boolean | undefined;
+                colSpan?: number | undefined;
+                widget?: string | undefined;
+                dependsOn?: string | undefined;
+                visibleOn?: {
+                    dialect: "cel" | "js" | "cron" | "template";
+                    source?: string | undefined;
+                    ast?: unknown;
+                    meta?: {
+                        rationale?: string | undefined;
+                        generatedBy?: string | undefined;
+                    } | undefined;
+                } | {
+                    dialect: "cel" | "js" | "cron" | "template";
+                    source?: string | undefined;
+                    ast?: unknown;
+                    meta?: {
+                        rationale?: string | undefined;
+                        generatedBy?: string | undefined;
+                    } | undefined;
+                } | undefined;
+            })[];
+            label?: string | undefined;
+        }[] | undefined;
+        defaultSort?: {
+            field: string;
+            order: "asc" | "desc";
+        }[] | undefined;
+        sharing?: {
+            enabled: boolean;
+            allowAnonymous: boolean;
+            publicLink?: string | undefined;
+            password?: string | undefined;
+            allowedDomains?: string[] | undefined;
+            expiresAt?: string | undefined;
+        } | undefined;
+        submitBehavior?: {
+            kind: "thank-you";
+            title?: string | undefined;
+            message?: string | undefined;
+        } | {
+            kind: "redirect";
+            url: string;
+            delayMs?: number | undefined;
+        } | {
+            kind: "continue";
+        } | {
+            kind: "next-record";
+        } | undefined;
+        aria?: {
+            ariaLabel?: string | undefined;
+            ariaDescribedBy?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+    }> | undefined;
+};
+
 /**
  * SchemaRetriever — Keyword-based metadata retrieval for AI prompts.
  *
@@ -9249,4 +10141,4 @@ declare function buildAssistantRoutes(aiService: AIService, agentRuntime: AgentR
  */
 declare function buildToolRoutes(aiService: AIService, logger: Logger): RouteDefinition[];
 
-export { AIService, type AIServiceConfig, AIServicePlugin, type AIServicePluginOptions, type AgentChatContext, AgentRuntime, AiConversationObject, AiMessageObject, AiTraceObject, type CostEstimate, DATA_CHAT_AGENT, DATA_TOOL_DEFINITIONS, type DataToolContext, type FieldShape, type IConversationService, type IPackageRegistry, InMemoryConversationService, METADATA_ASSISTANT_AGENT, METADATA_TOOL_DEFINITIONS, MemoryLLMAdapter, type MetadataToolContext, ModelRegistry, type ModelRegistryConfig, NullTraceRecorder, ObjectQLConversationService, ObjectQLTraceRecorder, type ObjectShape, PACKAGE_TOOL_DEFINITIONS, type PackageToolContext, QUERY_DATA_TOOL, type QueryDataToolContext, type QueryPlan, type RouteDefinition, type RouteRequest, type RouteResponse, type RouteUserContext, type SchemaHit, SchemaRetriever, type SchemaRetrieverOptions, type SkillContext, SkillRegistry, type SkillSummary, type TokenUsage, type ToolExecutionResult, type ToolHandler, ToolRegistry, type TraceEvent, type TraceOperation, type TraceRecorder, VercelLLMAdapter, type VercelLLMAdapterConfig, addFieldTool, buildAIRoutes, buildAgentRoutes, buildAssistantRoutes, buildToolRoutes, buildTraceEvent, computeCost, createObjectTool, createPackageTool, createQueryDataHandler, deleteFieldTool, describeObjectTool, encodeStreamPart, encodeVercelDataStream, getActivePackageTool, getPackageTool, listObjectsTool, listPackagesTool, modifyFieldTool, registerDataTools, registerMetadataTools, registerPackageTools, registerQueryDataTool, setActivePackageTool };
+export { ACTIONS_EXECUTOR_SKILL, AIService, type AIServiceConfig, AIServicePlugin, type AIServicePluginOptions, type ActionToolsContext, type AgentChatContext, AgentRuntime, AiConversationObject, AiMessageObject, AiTraceObject, AiTraceView, type CostEstimate, DATA_CHAT_AGENT, DATA_EXPLORER_SKILL, DATA_TOOL_DEFINITIONS, type DataToolContext, type FieldShape, type IConversationService, type IPackageRegistry, InMemoryConversationService, METADATA_ASSISTANT_AGENT, METADATA_AUTHORING_SKILL, METADATA_TOOL_DEFINITIONS, MemoryLLMAdapter, type MetadataToolContext, ModelRegistry, type ModelRegistryConfig, NullTraceRecorder, ObjectQLConversationService, ObjectQLTraceRecorder, type ObjectShape, PACKAGE_TOOL_DEFINITIONS, type PackageToolContext, QUERY_DATA_TOOL, type QueryDataToolContext, type QueryPlan, type RouteDefinition, type RouteRequest, type RouteResponse, type RouteUserContext, type SchemaHit, SchemaRetriever, type SchemaRetrieverOptions, type SkillContext, SkillRegistry, type SkillSummary, type TokenUsage, type ToolExecutionResult, type ToolHandler, ToolRegistry, type TraceEvent, type TraceOperation, type TraceRecorder, VercelLLMAdapter, type VercelLLMAdapterConfig, actionSkipReason, actionToToolDefinition, actionToolName, addFieldTool, buildAIRoutes, buildAgentRoutes, buildAssistantRoutes, buildToolRoutes, buildTraceEvent, computeCost, createObjectTool, createPackageTool, createQueryDataHandler, deleteFieldTool, describeObjectTool, encodeStreamPart, encodeVercelDataStream, getActivePackageTool, getPackageTool, listObjectsTool, listPackagesTool, modifyFieldTool, registerActionsAsTools, registerDataTools, registerMetadataTools, registerPackageTools, registerQueryDataTool, setActivePackageTool };