@objectstack/spec 0.6.1 → 0.7.2

package/dist/ai/agent-action.zod.d.ts.map

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

package/dist/ai/agent-action.zod.js

@@ -0,0 +1,401 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntentActionMappingSchema = exports.AgentActionSequenceResultSchema = exports.AgentActionResultSchema = exports.AgentActionSequenceSchema = exports.AgentActionSchema = exports.ComponentActionParamsSchema = exports.WorkflowActionParamsSchema = exports.DataActionParamsSchema = exports.FormActionParamsSchema = exports.ViewActionParamsSchema = exports.NavigationActionParamsSchema = exports.UIActionTypeSchema = exports.ComponentActionTypeSchema = exports.WorkflowActionTypeSchema = exports.DataActionTypeSchema = exports.FormActionTypeSchema = exports.ViewActionTypeSchema = exports.NavigationActionTypeSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * AI Agent Action Protocol
+ *
+ * Defines how AI agents can interact with the UI by mapping natural language intents
+ * to structured UI actions. This enables agents to not only query data but also
+ * manipulate the interface, navigate between views, and trigger workflows.
+ *
+ * Architecture Alignment:
+ * - Salesforce Einstein: Action recommendations and automated UI interactions
+ * - ServiceNow Virtual Agent: UI action automation
+ * - Microsoft Power Virtual Agents: Bot actions and UI integration
+ *
+ * Use Cases:
+ * - "Open the new account form" → Navigate to form view
+ * - "Show me all active opportunities" → Navigate to list view with filter
+ * - "Create a new task for John" → Open form with pre-filled data
+ * - "Switch to the kanban view" → Change view mode
+ */
+// ==========================================
+// UI Action Types
+// ==========================================
+/**
+ * Navigation Action Types
+ * Actions that change the current view or location
+ */
+exports.NavigationActionTypeSchema = zod_1.z.enum([
+    'navigate_to_object_list', // Navigate to object list view
+    'navigate_to_object_form', // Navigate to object form (new/edit)
+    'navigate_to_record_detail', // Navigate to specific record detail page
+    'navigate_to_dashboard', // Navigate to dashboard
+    'navigate_to_report', // Navigate to report view
+    'navigate_to_app', // Switch to different app
+    'navigate_back', // Go back to previous view
+    'navigate_home', // Go to home page
+    'open_tab', // Open new tab
+    'close_tab', // Close current tab
+]);
+/**
+ * View Manipulation Action Types
+ * Actions that change how data is displayed
+ */
+exports.ViewActionTypeSchema = zod_1.z.enum([
+    'change_view_mode', // Switch between list/kanban/calendar/gantt
+    'apply_filter', // Apply filter to current view
+    'clear_filter', // Clear filters
+    'apply_sort', // Apply sorting
+    'change_grouping', // Change grouping (for kanban/pivot)
+    'show_columns', // Show/hide columns
+    'expand_record', // Expand record in list
+    'collapse_record', // Collapse record in list
+    'refresh_view', // Refresh current view
+    'export_data', // Export view data
+]);
+/**
+ * Form Action Types
+ * Actions that interact with forms
+ */
+exports.FormActionTypeSchema = zod_1.z.enum([
+    'create_record', // Create new record (submit form)
+    'update_record', // Update existing record
+    'delete_record', // Delete record
+    'fill_field', // Fill a specific form field
+    'clear_field', // Clear a form field
+    'submit_form', // Submit the form
+    'cancel_form', // Cancel form editing
+    'validate_form', // Validate form data
+    'save_draft', // Save as draft
+]);
+/**
+ * Data Action Types
+ * Actions that perform data operations
+ */
+exports.DataActionTypeSchema = zod_1.z.enum([
+    'select_record', // Select record(s) in list
+    'deselect_record', // Deselect record(s)
+    'select_all', // Select all records
+    'deselect_all', // Deselect all records
+    'bulk_update', // Bulk update selected records
+    'bulk_delete', // Bulk delete selected records
+    'bulk_export', // Bulk export selected records
+]);
+/**
+ * Workflow Action Types
+ * Actions that trigger workflows or automations
+ */
+exports.WorkflowActionTypeSchema = zod_1.z.enum([
+    'trigger_flow', // Trigger a flow/workflow
+    'trigger_approval', // Start approval process
+    'trigger_webhook', // Trigger webhook
+    'run_report', // Run a report
+    'send_email', // Send email
+    'send_notification', // Send notification
+    'schedule_task', // Schedule a task
+]);
+/**
+ * UI Component Action Types
+ * Actions that interact with UI components
+ */
+exports.ComponentActionTypeSchema = zod_1.z.enum([
+    'open_modal', // Open modal dialog
+    'close_modal', // Close modal dialog
+    'open_sidebar', // Open sidebar panel
+    'close_sidebar', // Close sidebar panel
+    'show_notification', // Show toast/notification
+    'hide_notification', // Hide notification
+    'open_dropdown', // Open dropdown menu
+    'close_dropdown', // Close dropdown menu
+    'toggle_section', // Toggle collapsible section
+]);
+/**
+ * All UI Action Types Combined
+ */
+exports.UIActionTypeSchema = zod_1.z.union([
+    exports.NavigationActionTypeSchema,
+    exports.ViewActionTypeSchema,
+    exports.FormActionTypeSchema,
+    exports.DataActionTypeSchema,
+    exports.WorkflowActionTypeSchema,
+    exports.ComponentActionTypeSchema,
+]);
+// ==========================================
+// Action Parameters
+// ==========================================
+/**
+ * Navigation Action Parameters
+ */
+exports.NavigationActionParamsSchema = zod_1.z.object({
+    object: zod_1.z.string().optional().describe('Object name (for object-specific navigation)'),
+    recordId: zod_1.z.string().optional().describe('Record ID (for detail page)'),
+    viewType: zod_1.z.enum(['list', 'form', 'detail', 'kanban', 'calendar', 'gantt']).optional(),
+    dashboardId: zod_1.z.string().optional().describe('Dashboard ID'),
+    reportId: zod_1.z.string().optional().describe('Report ID'),
+    appName: zod_1.z.string().optional().describe('App name'),
+    mode: zod_1.z.enum(['new', 'edit', 'view']).optional().describe('Form mode'),
+    openInNewTab: zod_1.z.boolean().optional().describe('Open in new tab'),
+});
+/**
+ * View Action Parameters
+ */
+exports.ViewActionParamsSchema = zod_1.z.object({
+    viewMode: zod_1.z.enum(['list', 'kanban', 'calendar', 'gantt', 'pivot']).optional(),
+    filters: zod_1.z.record(zod_1.z.any()).optional().describe('Filter conditions'),
+    sort: zod_1.z.array(zod_1.z.object({
+        field: zod_1.z.string(),
+        order: zod_1.z.enum(['asc', 'desc']),
+    })).optional(),
+    groupBy: zod_1.z.string().optional().describe('Field to group by'),
+    columns: zod_1.z.array(zod_1.z.string()).optional().describe('Columns to show/hide'),
+    recordId: zod_1.z.string().optional().describe('Record to expand/collapse'),
+    exportFormat: zod_1.z.enum(['csv', 'xlsx', 'pdf', 'json']).optional(),
+});
+/**
+ * Form Action Parameters
+ */
+exports.FormActionParamsSchema = zod_1.z.object({
+    object: zod_1.z.string().optional().describe('Object name'),
+    recordId: zod_1.z.string().optional().describe('Record ID (for edit/delete)'),
+    fieldValues: zod_1.z.record(zod_1.z.any()).optional().describe('Field name-value pairs'),
+    fieldName: zod_1.z.string().optional().describe('Specific field to fill/clear'),
+    fieldValue: zod_1.z.any().optional().describe('Value to set'),
+    validateOnly: zod_1.z.boolean().optional().describe('Validate without saving'),
+});
+/**
+ * Data Action Parameters
+ */
+exports.DataActionParamsSchema = zod_1.z.object({
+    recordIds: zod_1.z.array(zod_1.z.string()).optional().describe('Record IDs to select/operate on'),
+    filters: zod_1.z.record(zod_1.z.any()).optional().describe('Filter for bulk operations'),
+    updateData: zod_1.z.record(zod_1.z.any()).optional().describe('Data for bulk update'),
+    exportFormat: zod_1.z.enum(['csv', 'xlsx', 'pdf', 'json']).optional(),
+});
+/**
+ * Workflow Action Parameters
+ */
+exports.WorkflowActionParamsSchema = zod_1.z.object({
+    flowName: zod_1.z.string().optional().describe('Flow/workflow name'),
+    approvalProcessName: zod_1.z.string().optional().describe('Approval process name'),
+    webhookUrl: zod_1.z.string().optional().describe('Webhook URL'),
+    reportName: zod_1.z.string().optional().describe('Report name'),
+    emailTemplate: zod_1.z.string().optional().describe('Email template'),
+    recipients: zod_1.z.array(zod_1.z.string()).optional().describe('Email recipients'),
+    subject: zod_1.z.string().optional().describe('Email subject'),
+    message: zod_1.z.string().optional().describe('Notification/email message'),
+    taskData: zod_1.z.record(zod_1.z.any()).optional().describe('Task creation data'),
+    scheduleTime: zod_1.z.string().optional().describe('Schedule time (ISO 8601)'),
+    contextData: zod_1.z.record(zod_1.z.any()).optional().describe('Additional context data'),
+});
+/**
+ * Component Action Parameters
+ */
+exports.ComponentActionParamsSchema = zod_1.z.object({
+    componentId: zod_1.z.string().optional().describe('Component ID'),
+    modalConfig: zod_1.z.object({
+        title: zod_1.z.string().optional(),
+        content: zod_1.z.any().optional(),
+        size: zod_1.z.enum(['small', 'medium', 'large', 'fullscreen']).optional(),
+    }).optional(),
+    notificationConfig: zod_1.z.object({
+        type: zod_1.z.enum(['info', 'success', 'warning', 'error']).optional(),
+        message: zod_1.z.string(),
+        duration: zod_1.z.number().optional().describe('Duration in ms'),
+    }).optional(),
+    sidebarConfig: zod_1.z.object({
+        position: zod_1.z.enum(['left', 'right']).optional(),
+        width: zod_1.z.string().optional(),
+        content: zod_1.z.any().optional(),
+    }).optional(),
+});
+// ==========================================
+// Agent Action Schema
+// ==========================================
+/**
+ * Agent UI Action Schema
+ * Complete definition of an AI agent's UI action
+ */
+exports.AgentActionSchema = zod_1.z.object({
+    /**
+     * Action identifier (generated)
+     */
+    id: zod_1.z.string().optional().describe('Unique action ID'),
+    /**
+     * Action type
+     */
+    type: exports.UIActionTypeSchema.describe('Type of UI action to perform'),
+    /**
+     * Action parameters (discriminated union based on type)
+     */
+    params: zod_1.z.union([
+        exports.NavigationActionParamsSchema,
+        exports.ViewActionParamsSchema,
+        exports.FormActionParamsSchema,
+        exports.DataActionParamsSchema,
+        exports.WorkflowActionParamsSchema,
+        exports.ComponentActionParamsSchema,
+    ]).describe('Action-specific parameters'),
+    /**
+     * Confirmation requirement
+     */
+    requireConfirmation: zod_1.z.boolean().default(false).describe('Require user confirmation before executing'),
+    /**
+     * Confirmation message
+     */
+    confirmationMessage: zod_1.z.string().optional().describe('Message to show in confirmation dialog'),
+    /**
+     * Success message
+     */
+    successMessage: zod_1.z.string().optional().describe('Message to show on success'),
+    /**
+     * Error handling
+     */
+    onError: zod_1.z.enum(['retry', 'skip', 'abort']).default('abort').describe('Error handling strategy'),
+    /**
+     * Execution metadata
+     */
+    metadata: zod_1.z.object({
+        intent: zod_1.z.string().optional().describe('Original user intent/query'),
+        confidence: zod_1.z.number().min(0).max(1).optional().describe('Confidence score (0-1)'),
+        agentName: zod_1.z.string().optional().describe('Agent that generated this action'),
+        timestamp: zod_1.z.string().optional().describe('Generation timestamp (ISO 8601)'),
+    }).optional(),
+});
+/**
+ * Agent Action Sequence Schema
+ * Multiple actions to be executed in sequence
+ */
+exports.AgentActionSequenceSchema = zod_1.z.object({
+    /**
+     * Sequence identifier
+     */
+    id: zod_1.z.string().optional().describe('Unique sequence ID'),
+    /**
+     * Actions to execute
+     */
+    actions: zod_1.z.array(exports.AgentActionSchema).describe('Ordered list of actions'),
+    /**
+     * Execution mode
+     */
+    mode: zod_1.z.enum(['sequential', 'parallel']).default('sequential').describe('Execution mode'),
+    /**
+     * Stop on first error
+     */
+    stopOnError: zod_1.z.boolean().default(true).describe('Stop sequence on first error'),
+    /**
+     * Transaction mode (all-or-nothing)
+     */
+    atomic: zod_1.z.boolean().default(false).describe('Rollback all changes if any action fails'),
+    /**
+     * Metadata
+     */
+    metadata: zod_1.z.object({
+        intent: zod_1.z.string().optional().describe('Original user intent'),
+        confidence: zod_1.z.number().min(0).max(1).optional().describe('Overall confidence score'),
+        agentName: zod_1.z.string().optional().describe('Agent that generated this sequence'),
+    }).optional(),
+});
+/**
+ * Agent Action Result Schema
+ * Result of executing an agent action
+ */
+exports.AgentActionResultSchema = zod_1.z.object({
+    /**
+     * Action ID
+     */
+    actionId: zod_1.z.string().describe('ID of the executed action'),
+    /**
+     * Execution status
+     */
+    status: zod_1.z.enum(['success', 'error', 'cancelled', 'pending']).describe('Execution status'),
+    /**
+     * Result data
+     */
+    data: zod_1.z.any().optional().describe('Action result data'),
+    /**
+     * Error information
+     */
+    error: zod_1.z.object({
+        code: zod_1.z.string(),
+        message: zod_1.z.string(),
+        details: zod_1.z.any().optional(),
+    }).optional().describe('Error details if status is "error"'),
+    /**
+     * Execution metadata
+     */
+    metadata: zod_1.z.object({
+        startTime: zod_1.z.string().optional().describe('Execution start time (ISO 8601)'),
+        endTime: zod_1.z.string().optional().describe('Execution end time (ISO 8601)'),
+        duration: zod_1.z.number().optional().describe('Execution duration in ms'),
+    }).optional(),
+});
+/**
+ * Agent Action Sequence Result Schema
+ * Result of executing an action sequence
+ */
+exports.AgentActionSequenceResultSchema = zod_1.z.object({
+    /**
+     * Sequence ID
+     */
+    sequenceId: zod_1.z.string().describe('ID of the executed sequence'),
+    /**
+     * Overall status
+     */
+    status: zod_1.z.enum(['success', 'partial_success', 'error', 'cancelled']).describe('Overall execution status'),
+    /**
+     * Individual action results
+     */
+    results: zod_1.z.array(exports.AgentActionResultSchema).describe('Results for each action'),
+    /**
+     * Summary
+     */
+    summary: zod_1.z.object({
+        total: zod_1.z.number().describe('Total number of actions'),
+        successful: zod_1.z.number().describe('Number of successful actions'),
+        failed: zod_1.z.number().describe('Number of failed actions'),
+        cancelled: zod_1.z.number().describe('Number of cancelled actions'),
+    }),
+    /**
+     * Execution metadata
+     */
+    metadata: zod_1.z.object({
+        startTime: zod_1.z.string().optional(),
+        endTime: zod_1.z.string().optional(),
+        totalDuration: zod_1.z.number().optional().describe('Total execution time in ms'),
+    }).optional(),
+});
+// ==========================================
+// Helper Schemas
+// ==========================================
+/**
+ * Intent to Action Mapping Schema
+ * Maps natural language intent patterns to UI actions
+ */
+exports.IntentActionMappingSchema = zod_1.z.object({
+    /**
+     * Intent pattern (regex or exact match)
+     */
+    intent: zod_1.z.string().describe('Intent pattern (e.g., "open_new_record_form")'),
+    /**
+     * Intent examples (for training)
+     */
+    examples: zod_1.z.array(zod_1.z.string()).optional().describe('Example user queries'),
+    /**
+     * Action template
+     */
+    actionTemplate: exports.AgentActionSchema.describe('Action to execute'),
+    /**
+     * Parameter extraction rules
+     */
+    paramExtraction: zod_1.z.record(zod_1.z.object({
+        type: zod_1.z.enum(['entity', 'slot', 'context']),
+        required: zod_1.z.boolean().default(false),
+        default: zod_1.z.any().optional(),
+    })).optional().describe('Rules for extracting parameters from user input'),
+    /**
+     * Confidence threshold
+     */
+    minConfidence: zod_1.z.number().min(0).max(1).default(0.7).describe('Minimum confidence to execute'),
+});

package/dist/ai/agent.zod.d.ts

@@ -30,11 +30,11 @@ export declare const AIToolSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    type: "flow" | "query" | "action" | "vector_search";
+    type: "query" | "flow" | "action" | "vector_search";
     name: string;
     description?: string | undefined;
 }, {
-    type: "flow" | "query" | "action" | "vector_search";
+    type: "query" | "flow" | "action" | "vector_search";
     name: string;
     description?: string | undefined;
 }>;
@@ -89,11 +89,11 @@ export declare const AgentSchema: z.ZodObject<{
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        type: "flow" | "query" | "action" | "vector_search";
+        type: "query" | "flow" | "action" | "vector_search";
         name: string;
         description?: string | undefined;
     }, {
-        type: "flow" | "query" | "action" | "vector_search";
+        type: "query" | "flow" | "action" | "vector_search";
         name: string;
         description?: string | undefined;
     }>, "many">>;
@@ -117,6 +117,7 @@ export declare const AgentSchema: z.ZodObject<{
     role: string;
     instructions: string;
     avatar?: string | undefined;
+    access?: string[] | undefined;
     model?: {
         provider: "local" | "openai" | "azure_openai" | "anthropic";
         model: string;
@@ -125,7 +126,7 @@ export declare const AgentSchema: z.ZodObject<{
         topP?: number | undefined;
     } | undefined;
     tools?: {
-        type: "flow" | "query" | "action" | "vector_search";
+        type: "query" | "flow" | "action" | "vector_search";
         name: string;
         description?: string | undefined;
     }[] | undefined;
@@ -133,7 +134,6 @@ export declare const AgentSchema: z.ZodObject<{
         indexes: string[];
         topics: string[];
     } | undefined;
-    access?: string[] | undefined;
 }, {
     label: string;
     name: string;
@@ -141,6 +141,7 @@ export declare const AgentSchema: z.ZodObject<{
     instructions: string;
     avatar?: string | undefined;
     active?: boolean | undefined;
+    access?: string[] | undefined;
     model?: {
         model: string;
         provider?: "local" | "openai" | "azure_openai" | "anthropic" | undefined;
@@ -149,7 +150,7 @@ export declare const AgentSchema: z.ZodObject<{
         topP?: number | undefined;
     } | undefined;
     tools?: {
-        type: "flow" | "query" | "action" | "vector_search";
+        type: "query" | "flow" | "action" | "vector_search";
         name: string;
         description?: string | undefined;
     }[] | undefined;
@@ -157,7 +158,6 @@ export declare const AgentSchema: z.ZodObject<{
         indexes: string[];
         topics: string[];
     } | undefined;
-    access?: string[] | undefined;
 }>;
 export type Agent = z.infer<typeof AgentSchema>;
 export type AITool = z.infer<typeof AIToolSchema>;