@revealui/contracts 1.0.0

package/dist/a2a/index.js

@@ -0,0 +1,276 @@
+/**
+ * A2A (Agent-to-Agent) Protocol Contracts
+ *
+ * Implements the Google A2A specification as Zod schemas, bound to RevealUI's
+ * existing AgentDefinition and ToolDefinition contracts. This enables RevealUI
+ * agents to interoperate with any A2A-compatible orchestrator (LangGraph,
+ * Google ADK, Vertex AI, etc.).
+ *
+ * Spec: https://google.github.io/A2A
+ *
+ * Binding:
+ *   AgentDefinition → A2AAgentCard
+ *   ToolDefinition  → A2ASkill
+ */
+import { z } from 'zod/v4';
+// =============================================================================
+// Agent Card — discovery document served at /.well-known/agent.json
+// =============================================================================
+/**
+ * A skill exposed by an A2A agent (maps from ToolDefinition)
+ */
+export const A2ASkillSchema = z.object({
+    /** Unique skill identifier (maps from ToolDefinition.name) */
+    id: z.string(),
+    /** Human-readable name */
+    name: z.string(),
+    /** Description of what this skill does */
+    description: z.string(),
+    /** Categorisation tags */
+    tags: z.array(z.string()).optional(),
+    /** Example prompts that invoke this skill */
+    examples: z.array(z.string()).optional(),
+    /** Supported input modalities */
+    inputModes: z.array(z.string()).default(['text']),
+    /** Supported output modalities */
+    outputModes: z.array(z.string()).default(['text']),
+});
+/**
+ * Agent capabilities flags
+ */
+export const A2ACapabilitiesSchema = z.object({
+    /** Whether the agent supports SSE streaming via tasks/sendSubscribe */
+    streaming: z.boolean().default(false),
+    /** Whether the agent can push notifications to a webhook */
+    pushNotifications: z.boolean().default(false),
+    /** Whether the agent includes full task history in responses */
+    stateTransitionHistory: z.boolean().default(false),
+});
+/**
+ * Provider information
+ */
+export const A2AProviderSchema = z.object({
+    organization: z.string(),
+    url: z.string().url().optional(),
+});
+/**
+ * Authentication configuration
+ */
+export const A2AAuthSchema = z.object({
+    /** Supported auth schemes */
+    schemes: z.array(z.enum(['Bearer', 'ApiKey', 'OAuth2', 'None'])).default(['Bearer']),
+    /** Optional credentials hint (never put actual secrets here) */
+    credentials: z.string().nullable().default(null),
+});
+/**
+ * A2A Agent Card — the full discovery document.
+ * Served at /.well-known/agent.json (platform) or
+ * /.well-known/agents/:id/agent.json (per-agent).
+ */
+export const A2AAgentCardSchema = z.object({
+    /** Agent display name */
+    name: z.string(),
+    /** Human-readable description */
+    description: z.string(),
+    /** The A2A task endpoint URL */
+    url: z.string().url(),
+    /** Agent Card URL (self-reference) */
+    documentationUrl: z.string().url().optional(),
+    /** Provider / publisher info */
+    provider: A2AProviderSchema.optional(),
+    /** Semver version string */
+    version: z.string().default('1.0.0'),
+    /** Protocol capabilities */
+    capabilities: A2ACapabilitiesSchema,
+    /** Authentication requirements */
+    authentication: A2AAuthSchema,
+    /** Accepted input modalities */
+    defaultInputModes: z.array(z.string()).default(['text']),
+    /** Produced output modalities */
+    defaultOutputModes: z.array(z.string()).default(['text']),
+    /** Skills this agent exposes */
+    skills: z.array(A2ASkillSchema),
+});
+// =============================================================================
+// Task & Message — runtime protocol types
+// =============================================================================
+/**
+ * Text part of a message
+ */
+export const A2ATextPartSchema = z.object({
+    type: z.literal('text'),
+    text: z.string(),
+});
+/**
+ * Structured data part of a message
+ */
+export const A2ADataPartSchema = z.object({
+    type: z.literal('data'),
+    data: z.record(z.string(), z.unknown()),
+    mimeType: z.string().optional(),
+});
+/**
+ * File/binary part of a message
+ */
+export const A2AFilePartSchema = z.object({
+    type: z.literal('file'),
+    mimeType: z.string(),
+    /** Base64-encoded file data */
+    data: z.string(),
+    /** Optional filename hint */
+    name: z.string().optional(),
+});
+/** Discriminated union of all part types */
+export const A2APartSchema = z.discriminatedUnion('type', [
+    A2ATextPartSchema,
+    A2ADataPartSchema,
+    A2AFilePartSchema,
+]);
+/**
+ * A single message in a task conversation
+ */
+export const A2AMessageSchema = z.object({
+    /** Who authored this message */
+    role: z.enum(['user', 'agent']),
+    /** Content parts */
+    parts: z.array(A2APartSchema),
+    /** Optional message-level metadata */
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+/**
+ * Task lifecycle states
+ */
+export const A2ATaskStateSchema = z.enum([
+    'submitted',
+    'working',
+    'input-required',
+    'completed',
+    'canceled',
+    'failed',
+    'unknown',
+]);
+/**
+ * Task status snapshot
+ */
+export const A2ATaskStatusSchema = z.object({
+    state: A2ATaskStateSchema,
+    message: A2AMessageSchema.optional(),
+    timestamp: z.string().datetime(),
+});
+/**
+ * An artifact produced by a task
+ */
+export const A2AArtifactSchema = z.object({
+    name: z.string().optional(),
+    description: z.string().optional(),
+    parts: z.array(A2APartSchema),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+    index: z.number().int().default(0),
+    append: z.boolean().optional(),
+    lastChunk: z.boolean().optional(),
+});
+/**
+ * A complete A2A Task entity
+ */
+export const A2ATaskSchema = z.object({
+    /** Server-assigned task ID */
+    id: z.string(),
+    /** Optional session ID for grouping related tasks */
+    sessionId: z.string().optional(),
+    /** Current task status */
+    status: A2ATaskStatusSchema,
+    /** Produced artifacts (available when state=completed) */
+    artifacts: z.array(A2AArtifactSchema).optional(),
+    /** Full message history (when stateTransitionHistory=true) */
+    history: z.array(A2AMessageSchema).optional(),
+    /** Arbitrary task-level metadata */
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+// =============================================================================
+// JSON-RPC 2.0 envelope
+// =============================================================================
+export const A2AJsonRpcRequestSchema = z.object({
+    jsonrpc: z.literal('2.0'),
+    id: z.union([z.string(), z.number()]),
+    method: z.string(),
+    params: z.record(z.string(), z.unknown()).optional(),
+});
+export const A2AJsonRpcErrorSchema = z.object({
+    code: z.number().int(),
+    message: z.string(),
+    data: z.unknown().optional(),
+});
+export const A2AJsonRpcResponseSchema = z.object({
+    jsonrpc: z.literal('2.0'),
+    id: z.union([z.string(), z.number()]),
+    result: z.unknown().optional(),
+    error: A2AJsonRpcErrorSchema.optional(),
+});
+// =============================================================================
+// tasks/send params
+// =============================================================================
+export const A2ASendTaskParamsSchema = z.object({
+    /** Optional task ID (server generates one if omitted) */
+    id: z.string().optional(),
+    /** Optional session ID */
+    sessionId: z.string().optional(),
+    /** The initial user message */
+    message: A2AMessageSchema,
+    /** Arbitrary caller metadata */
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+// =============================================================================
+// Mapper functions — bind A2A spec to RevealUI contracts
+// =============================================================================
+/**
+ * Convert a RevealUI ToolDefinition to an A2A Skill.
+ * ToolDefinition.name → Skill.id
+ * ToolDefinition.examples[].description → Skill.examples
+ */
+export function toolDefinitionToSkill(tool) {
+    return {
+        id: tool.name,
+        name: tool.name
+            .replace(/([A-Z])/g, ' $1')
+            .replace(/^./, (s) => s.toUpperCase())
+            .trim(),
+        description: tool.description,
+        tags: tool.requiredCapabilities ?? [],
+        examples: tool.examples?.map((e) => e.description ?? JSON.stringify(e.input)).filter(Boolean),
+        inputModes: ['text'],
+        outputModes: ['text'],
+    };
+}
+/**
+ * Convert a RevealUI AgentDefinition to an A2A Agent Card.
+ *
+ * @param def - The AgentDefinition from @revealui/contracts
+ * @param baseUrl - The public base URL of the A2A endpoint (e.g. https://api.revealui.com)
+ */
+export function agentDefinitionToCard(def, baseUrl) {
+    const url = baseUrl.replace(/\/$/, '');
+    return {
+        name: def.name,
+        description: def.description,
+        url: `${url}/a2a`,
+        documentationUrl: `${url}/docs`,
+        provider: {
+            organization: 'RevealUI Studio',
+            url: 'https://revealui.com',
+        },
+        version: String(def.version),
+        capabilities: {
+            streaming: true,
+            pushNotifications: false,
+            stateTransitionHistory: false,
+        },
+        authentication: {
+            schemes: ['Bearer'],
+            credentials: null,
+        },
+        defaultInputModes: ['text'],
+        defaultOutputModes: ['text'],
+        skills: def.tools.map(toolDefinitionToSkill),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/a2a/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/a2a/index.ts"],"names":[],"mappings":"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"}

package/dist/actions/action-validator.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Action Validation Layer
+ *
+ * Validates actions against entity constraints, agent capabilities, and permissions.
+ * This provides runtime enforcement of the constraints defined in entity schemas.
+ *
+ * @module @revealui/contracts/actions
+ */
+import type { AgentDefinition } from '@revealui/contracts/agents';
+import type { AgentConstraint, DualEntity } from '../representation/index.js';
+export interface ActionValidationContext {
+    /** The entity being acted upon */
+    entity: DualEntity;
+    /** The action name (e.g., 'update', 'delete', 'addBlock') */
+    action: string;
+    /** The agent attempting the action */
+    agent: AgentDefinition;
+    /** Proposed changes (for update/create actions) */
+    changes?: Record<string, unknown>;
+    /** User permissions (for permission-based constraints) */
+    permissions?: string[];
+    /** Additional context */
+    context?: Record<string, unknown>;
+}
+export interface ActionValidationSuccess {
+    success: true;
+    allowed: true;
+    warnings?: string[];
+}
+export interface ActionValidationFailure {
+    success: false;
+    allowed: false;
+    errors: ActionValidationError[];
+}
+export interface ActionValidationError {
+    code: string;
+    message: string;
+    field?: string;
+    constraint?: AgentConstraint;
+}
+export type ActionValidationResult = ActionValidationSuccess | ActionValidationFailure;
+/**
+ * Validate an action against entity constraints, agent capabilities, and permissions
+ *
+ * This is the main entry point for action validation in @revealui/contracts/actions
+ */
+export declare function validateAction(context: ActionValidationContext): ActionValidationResult;
+//# sourceMappingURL=action-validator.d.ts.map

package/dist/actions/action-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-validator.d.ts","sourceRoot":"","sources":["../../src/actions/action-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,KAAK,EAAyB,eAAe,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAMpG,MAAM,WAAW,uBAAuB;IACtC,kCAAkC;IAClC,MAAM,EAAE,UAAU,CAAA;IAElB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAA;IAEd,sCAAsC;IACtC,KAAK,EAAE,eAAe,CAAA;IAEtB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEjC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IAEtB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,IAAI,CAAA;IACb,OAAO,EAAE,IAAI,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,KAAK,CAAA;IACd,OAAO,EAAE,KAAK,CAAA;IACd,MAAM,EAAE,qBAAqB,EAAE,CAAA;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,eAAe,CAAA;CAC7B;AAED,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,GAAG,uBAAuB,CAAA;AAmRtF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAsDvF"}

package/dist/actions/action-validator.js

@@ -0,0 +1,288 @@
+/**
+ * Action Validation Layer
+ *
+ * Validates actions against entity constraints, agent capabilities, and permissions.
+ * This provides runtime enforcement of the constraints defined in entity schemas.
+ *
+ * @module @revealui/contracts/actions
+ */
+// =============================================================================
+// Constraint Checking
+// =============================================================================
+/**
+ * Check if changes violate entity constraints
+ */
+function checkConstraints(entity, changes) {
+    if (!changes)
+        return { success: true, allowed: true };
+    const constraints = entity.agent?.constraints || [];
+    const errors = [];
+    for (const constraint of constraints) {
+        const result = checkSingleConstraint(constraint, entity, changes);
+        if (!result.allowed) {
+            errors.push(...result.errors);
+        }
+    }
+    if (errors.length > 0) {
+        return { success: false, allowed: false, errors };
+    }
+    return { success: true, allowed: true };
+}
+/**
+ * Check a single constraint
+ */
+function checkSingleConstraint(constraint, entity, changes) {
+    const { type, field, params, message } = constraint;
+    // If constraint applies to a specific field, only check if that field is changing
+    if (field && !(field in changes)) {
+        return { success: true, allowed: true };
+    }
+    const value = field ? changes[field] : changes;
+    switch (type) {
+        case 'readonly':
+            if (field && field in changes) {
+                return {
+                    success: false,
+                    allowed: false,
+                    errors: [
+                        {
+                            code: 'READONLY_FIELD',
+                            message: message || `Field '${field}' is readonly`,
+                            field,
+                            constraint,
+                        },
+                    ],
+                };
+            }
+            break;
+        case 'required':
+            if (field && (!value || value === '')) {
+                return {
+                    success: false,
+                    allowed: false,
+                    errors: [
+                        {
+                            code: 'REQUIRED_FIELD',
+                            message: message || `Field '${field}' is required`,
+                            field,
+                            constraint,
+                        },
+                    ],
+                };
+            }
+            break;
+        case 'immutable': {
+            // Check if field already has a value (immutable after creation)
+            const currentValue = field ? entity[field] : entity;
+            if (currentValue !== undefined && value !== currentValue) {
+                return {
+                    success: false,
+                    allowed: false,
+                    errors: [
+                        {
+                            code: 'IMMUTABLE_FIELD',
+                            message: message || `Field '${field}' cannot be changed after creation`,
+                            ...(field && { field }),
+                            constraint,
+                        },
+                    ],
+                };
+            }
+            break;
+        }
+        case 'range':
+            if (typeof value === 'number' && params) {
+                const min = params.min;
+                const max = params.max;
+                if ((min !== undefined && value < min) || (max !== undefined && value > max)) {
+                    return {
+                        success: false,
+                        allowed: false,
+                        errors: [
+                            {
+                                code: 'RANGE_VIOLATION',
+                                message: message || `Value must be between ${min} and ${max}`,
+                                ...(field && { field }),
+                                constraint,
+                            },
+                        ],
+                    };
+                }
+            }
+            break;
+        case 'pattern': {
+            if (typeof value === 'string') {
+                const pattern = typeof params?.pattern === 'string' ? params.pattern : null;
+                if (pattern) {
+                    const regex = new RegExp(pattern);
+                    if (!regex.test(value)) {
+                        return {
+                            success: false,
+                            allowed: false,
+                            errors: [
+                                {
+                                    code: 'PATTERN_VIOLATION',
+                                    message: message || `Value must match pattern ${pattern}`,
+                                    ...(field && { field }),
+                                    constraint,
+                                },
+                            ],
+                        };
+                    }
+                }
+            }
+            break;
+        }
+        case 'capability':
+            // Handled separately in checkCapabilities
+            break;
+        case 'permission':
+            // Handled separately in checkPermissions
+            break;
+        case 'custom': {
+            // Custom constraint logic would be evaluated here
+            const validator = params?.validator;
+            if (typeof validator === 'function') {
+                const customResult = validator(value, entity, changes);
+                if (!customResult) {
+                    return {
+                        success: false,
+                        allowed: false,
+                        errors: [
+                            {
+                                code: 'CUSTOM_CONSTRAINT_FAILED',
+                                message: message || 'Custom constraint validation failed',
+                                ...(field && { field }),
+                                constraint,
+                            },
+                        ],
+                    };
+                }
+            }
+            break;
+        }
+    }
+    return { success: true, allowed: true };
+}
+// =============================================================================
+// Capability Checking
+// =============================================================================
+/**
+ * Check if agent has required capabilities for action
+ */
+function checkCapabilities(agent, requiredCapabilities) {
+    const agentCapabilities = agent.capabilities || [];
+    const missing = requiredCapabilities.filter((cap) => !agentCapabilities.includes(cap));
+    if (missing.length > 0) {
+        return {
+            success: false,
+            allowed: false,
+            errors: [
+                {
+                    code: 'MISSING_CAPABILITY',
+                    message: `Agent missing required capabilities: ${missing.join(', ')}`,
+                },
+            ],
+        };
+    }
+    return { success: true, allowed: true };
+}
+// =============================================================================
+// Permission Checking
+// =============================================================================
+/**
+ * Check if user has required permissions for action
+ */
+function checkPermissions(permissions, actionDef) {
+    // If action doesn't require permissions, allow it
+    const requiredPermissions = actionDef.requiredCapabilities
+        ?.filter((cap) => cap.startsWith('permission:'))
+        .map((cap) => cap.replace('permission:', ''));
+    if (!requiredPermissions || requiredPermissions.length === 0) {
+        return { success: true, allowed: true };
+    }
+    if (!permissions || permissions.length === 0) {
+        return {
+            success: false,
+            allowed: false,
+            errors: [
+                {
+                    code: 'MISSING_PERMISSION',
+                    message: `Action requires permissions: ${requiredPermissions.join(', ')}`,
+                },
+            ],
+        };
+    }
+    const missing = requiredPermissions.filter((perm) => !permissions.includes(perm));
+    if (missing.length > 0) {
+        return {
+            success: false,
+            allowed: false,
+            errors: [
+                {
+                    code: 'MISSING_PERMISSION',
+                    message: `Missing permissions: ${missing.join(', ')}`,
+                },
+            ],
+        };
+    }
+    return { success: true, allowed: true };
+}
+// =============================================================================
+// Action Validation (Main Entry Point)
+// =============================================================================
+/**
+ * Validate an action against entity constraints, agent capabilities, and permissions
+ *
+ * This is the main entry point for action validation in @revealui/contracts/actions
+ */
+export function validateAction(context) {
+    const { entity, action, agent, changes, permissions } = context;
+    // 1. Check if action is defined on entity
+    const actionDef = entity.agent?.actions?.find((a) => a.name === action);
+    if (!actionDef) {
+        return {
+            success: false,
+            allowed: false,
+            errors: [
+                {
+                    code: 'ACTION_NOT_FOUND',
+                    message: `Action '${action}' is not available on this entity`,
+                },
+            ],
+        };
+    }
+    // 2. Check if action is destructive and requires confirmation
+    if (actionDef.destructive && !context.context?.confirmed) {
+        return {
+            success: false,
+            allowed: false,
+            errors: [
+                {
+                    code: 'DESTRUCTIVE_ACTION_REQUIRES_CONFIRMATION',
+                    message: `Action '${action}' is destructive and requires confirmation`,
+                },
+            ],
+        };
+    }
+    // 3. Check constraints
+    const constraintResult = checkConstraints(entity, changes);
+    if (!constraintResult.success) {
+        return constraintResult;
+    }
+    // 4. Check capabilities
+    if (actionDef.requiredCapabilities) {
+        const capabilityResult = checkCapabilities(agent, actionDef.requiredCapabilities);
+        if (!capabilityResult.success) {
+            return capabilityResult;
+        }
+    }
+    // 5. Check permissions
+    const permissionResult = checkPermissions(permissions, actionDef);
+    if (!permissionResult.success) {
+        return permissionResult;
+    }
+    // All checks passed
+    return { success: true, allowed: true };
+}
+//# sourceMappingURL=action-validator.js.map

package/dist/actions/action-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-validator.js","sourceRoot":"","sources":["../../src/actions/action-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkDH,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;GAEG;AACH,SAAS,gBAAgB,CACvB,MAAkB,EAClB,OAA4C;IAE5C,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAErD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,EAAE,WAAW,IAAI,EAAE,CAAA;IACnD,MAAM,MAAM,GAA4B,EAAE,CAAA;IAE1C,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;QACjE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;IACnD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AACzC,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC5B,UAA2B,EAC3B,MAAkB,EAClB,OAAgC;IAEhC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAA;IAEnD,kFAAkF;IAClF,IAAI,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACzC,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;IAE9C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU;YACb,IAAI,KAAK,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC9B,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE;wBACN;4BACE,IAAI,EAAE,gBAAgB;4BACtB,OAAO,EAAE,OAAO,IAAI,UAAU,KAAK,eAAe;4BAClD,KAAK;4BACL,UAAU;yBACX;qBACF;iBACF,CAAA;YACH,CAAC;YACD,MAAK;QAEP,KAAK,UAAU;YACb,IAAI,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,KAAK,KAAK,EAAE,CAAC,EAAE,CAAC;gBACtC,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE;wBACN;4BACE,IAAI,EAAE,gBAAgB;4BACtB,OAAO,EAAE,OAAO,IAAI,UAAU,KAAK,eAAe;4BAClD,KAAK;4BACL,UAAU;yBACX;qBACF;iBACF,CAAA;YACH,CAAC;YACD,MAAK;QAEP,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,gEAAgE;YAChE,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAE,MAAkC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;YAChF,IAAI,YAAY,KAAK,SAAS,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;gBACzD,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE;wBACN;4BACE,IAAI,EAAE,iBAAiB;4BACvB,OAAO,EAAE,OAAO,IAAI,UAAU,KAAK,oCAAoC;4BACvE,GAAG,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC;4BACvB,UAAU;yBACX;qBACF;iBACF,CAAA;YACH,CAAC;YACD,MAAK;QACP,CAAC;QAED,KAAK,OAAO;YACV,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,EAAE,CAAC;gBACxC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAyB,CAAA;gBAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAyB,CAAA;gBAC5C,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC;oBAC7E,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,OAAO,EAAE,KAAK;wBACd,MAAM,EAAE;4BACN;gCACE,IAAI,EAAE,iBAAiB;gCACvB,OAAO,EAAE,OAAO,IAAI,yBAAyB,GAAG,QAAQ,GAAG,EAAE;gCAC7D,GAAG,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC;gCACvB,UAAU;6BACX;yBACF;qBACF,CAAA;gBACH,CAAC;YACH,CAAC;YACD,MAAK;QAEP,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,OAAO,MAAM,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;gBAC3E,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAA;oBACjC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;wBACvB,OAAO;4BACL,OAAO,EAAE,KAAK;4BACd,OAAO,EAAE,KAAK;4BACd,MAAM,EAAE;gCACN;oCACE,IAAI,EAAE,mBAAmB;oCACzB,OAAO,EAAE,OAAO,IAAI,4BAA4B,OAAO,EAAE;oCACzD,GAAG,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC;oCACvB,UAAU;iCACX;6BACF;yBACF,CAAA;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YACD,MAAK;QACP,CAAC;QAED,KAAK,YAAY;YACf,0CAA0C;YAC1C,MAAK;QAEP,KAAK,YAAY;YACf,yCAAyC;YACzC,MAAK;QAEP,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,kDAAkD;YAClD,MAAM,SAAS,GAAG,MAAM,EAAE,SAAS,CAAA;YACnC,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;gBACpC,MAAM,YAAY,GAChB,SAKD,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;gBACzB,IAAI,CAAC,YAAY,EAAE,CAAC;oBAClB,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,OAAO,EAAE,KAAK;wBACd,MAAM,EAAE;4BACN;gCACE,IAAI,EAAE,0BAA0B;gCAChC,OAAO,EAAE,OAAO,IAAI,qCAAqC;gCACzD,GAAG,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC;gCACvB,UAAU;6BACX;yBACF;qBACF,CAAA;gBACH,CAAC;YACH,CAAC;YACD,MAAK;QACP,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AACzC,CAAC;AAED,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;GAEG;AACH,SAAS,iBAAiB,CACxB,KAAsB,EACtB,oBAA8B;IAE9B,MAAM,iBAAiB,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAA;IAClD,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;IAE9F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,KAAK;YACd,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,oBAAoB;oBAC1B,OAAO,EAAE,wCAAwC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBACtE;aACF;SACF,CAAA;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AACzC,CAAC;AAED,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;GAEG;AACH,SAAS,gBAAgB,CACvB,WAAiC,EACjC,SAAgC;IAEhC,kDAAkD;IAClD,MAAM,mBAAmB,GAAG,SAAS,CAAC,oBAAoB;QACxD,EAAE,MAAM,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;SACvD,GAAG,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAA;IAEvD,IAAI,CAAC,mBAAmB,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACzC,CAAC;IAED,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,KAAK;YACd,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,oBAAoB;oBAC1B,OAAO,EAAE,gCAAgC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBAC1E;aACF;SACF,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;IAEzF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,KAAK;YACd,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,oBAAoB;oBAC1B,OAAO,EAAE,wBAAwB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBACtD;aACF;SACF,CAAA;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AACzC,CAAC;AAED,gFAAgF;AAChF,uCAAuC;AACvC,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgC;IAC7D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAA;IAE/D,0CAA0C;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAwB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAA;IAC9F,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,KAAK;YACd,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,kBAAkB;oBACxB,OAAO,EAAE,WAAW,MAAM,mCAAmC;iBAC9D;aACF;SACF,CAAA;IACH,CAAC;IAED,8DAA8D;IAC9D,IAAI,SAAS,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;QACzD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,KAAK;YACd,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,0CAA0C;oBAChD,OAAO,EAAE,WAAW,MAAM,4CAA4C;iBACvE;aACF;SACF,CAAA;IACH,CAAC;IAED,uBAAuB;IACvB,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC1D,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAC9B,OAAO,gBAAgB,CAAA;IACzB,CAAC;IAED,wBAAwB;IACxB,IAAI,SAAS,CAAC,oBAAoB,EAAE,CAAC;QACnC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,oBAAoB,CAAC,CAAA;QACjF,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC9B,OAAO,gBAAgB,CAAA;QACzB,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IACjE,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAC9B,OAAO,gBAAgB,CAAA;IACzB,CAAC;IAED,oBAAoB;IACpB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AACzC,CAAC"}

package/dist/actions/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @revealui/contracts/actions
+ *
+ * Action validation layer - validates actions against entity constraints
+ */
+export { type ActionValidationContext, type ActionValidationError, type ActionValidationFailure, type ActionValidationResult, type ActionValidationSuccess, validateAction, } from './action-validator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,cAAc,GACf,MAAM,uBAAuB,CAAA"}

package/dist/actions/index.js

@@ -0,0 +1,7 @@
+/**
+ * @revealui/contracts/actions
+ *
+ * Action validation layer - validates actions against entity constraints
+ */
+export { validateAction, } from './action-validator.js';
+//# sourceMappingURL=index.js.map

package/dist/actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAML,cAAc,GACf,MAAM,uBAAuB,CAAA"}