@revealui/contracts 1.0.0

package/dist/representation/index.js

@@ -0,0 +1,280 @@
+/**
+ * Dual Representation Layer
+ *
+ * Every entity in RevealUI has two faces:
+ * 1. Human: Visual, intuitive, natural language
+ * 2. Agent: Structured, typed, optimized for reasoning
+ *
+ * This module provides the types and utilities for bridging both.
+ *
+ * IMPORTANT: Agent representations are metadata that describe how agents
+ * should interact with entities. The actual enforcement happens in the
+ * @revealui/actions and @revealui/ai packages at runtime.
+ */
+import { z } from 'zod/v4';
+// =============================================================================
+// Schema Version
+// =============================================================================
+/**
+ * Current schema version for the representation layer.
+ * Increment when making breaking changes to schemas.
+ */
+export const REPRESENTATION_SCHEMA_VERSION = 1;
+// =============================================================================
+// Embedding Configuration
+// =============================================================================
+/**
+ * Supported embedding models and their dimensions.
+ * Add new models as needed.
+ */
+export const EMBEDDING_DIMENSIONS = {
+    'openai-text-embedding-3-small': 1536,
+    'openai-text-embedding-3-large': 3072,
+    'openai-text-embedding-ada-002': 1536,
+    'cohere-embed-english-v3': 1024,
+    'cohere-embed-multilingual-v3': 1024,
+    'voyage-large-2': 1536,
+    custom: 0, // Variable dimension, must be specified
+};
+/**
+ * Default embedding model and dimension
+ */
+export const DEFAULT_EMBEDDING_MODEL = 'openai-text-embedding-3-small';
+export const DEFAULT_EMBEDDING_DIMENSION = EMBEDDING_DIMENSIONS[DEFAULT_EMBEDDING_MODEL];
+// =============================================================================
+// Embedding Schema
+// =============================================================================
+/**
+ * Embedding with model information for proper validation
+ */
+export const EmbeddingSchema = z
+    .object({
+    /** The embedding model used */
+    model: z.string(),
+    /** The embedding vector */
+    vector: z.array(z.number()),
+    /** Dimension of the vector (for validation) */
+    dimension: z.number().int().positive(),
+    /** When this embedding was generated */
+    generatedAt: z.string().datetime(),
+})
+    .refine((data) => data.vector.length === data.dimension, {
+    message: 'Embedding vector length must match specified dimension',
+});
+/**
+ * Creates an embedding with validation
+ */
+export function createEmbedding(vector, model = DEFAULT_EMBEDDING_MODEL) {
+    const dimension = vector.length;
+    // Validate against known models if model is known
+    if (model in EMBEDDING_DIMENSIONS) {
+        const expectedDimension = EMBEDDING_DIMENSIONS[model];
+        // 0 means custom/variable dimension, skip validation
+        if (expectedDimension !== 0 && expectedDimension !== dimension) {
+            throw new Error(`Embedding dimension mismatch: expected ${expectedDimension} for model ${model}, got ${dimension}`);
+        }
+    }
+    return {
+        model,
+        vector,
+        dimension,
+        generatedAt: new Date().toISOString(),
+    };
+}
+// =============================================================================
+// Human Representation
+// =============================================================================
+/**
+ * How an entity appears to humans
+ */
+export const HumanRepresentationSchema = z.object({
+    /** Display name shown in UI */
+    label: z.string(),
+    /** Natural language description */
+    description: z.string().optional(),
+    /** Icon identifier (for UI rendering) */
+    icon: z.string().optional(),
+    /** Color hint for visual distinction */
+    color: z.string().optional(),
+    /** Preview text (for search results, tooltips) */
+    preview: z.string().optional(),
+    /** Suggested actions in natural language */
+    suggestions: z.array(z.string()).optional(),
+    /** Help text for this entity */
+    helpText: z.string().optional(),
+});
+// =============================================================================
+// Agent Constraint
+// =============================================================================
+/**
+ * A constraint that agents must respect
+ */
+export const AgentConstraintSchema = z.object({
+    /** Constraint type */
+    type: z.enum([
+        'readonly', // Cannot modify
+        'required', // Must have a value
+        'immutable', // Cannot change after creation
+        'range', // Value must be in range
+        'pattern', // Value must match pattern
+        'dependency', // Depends on another field
+        'capability', // Requires agent capability
+        'permission', // Requires user permission
+        'custom', // Custom constraint logic
+    ]),
+    /** Field this constraint applies to (if applicable) */
+    field: z.string().optional(),
+    /** Constraint parameters */
+    params: z.record(z.string(), z.unknown()),
+    /** Human-readable explanation of the constraint */
+    message: z.string().optional(),
+});
+// =============================================================================
+// Agent Action
+// =============================================================================
+/**
+ * An action that agents can perform on this entity
+ */
+export const AgentActionDefinitionSchema = z.object({
+    /** Action name (machine-readable) */
+    name: z.string(),
+    /** Human-readable description */
+    description: z.string(),
+    /** Parameter definitions */
+    params: z.record(z.string(), z.object({
+        type: z.string(),
+        required: z.boolean().optional(),
+        description: z.string().optional(),
+        default: z.unknown().optional(),
+        enum: z.array(z.string()).optional(),
+    })),
+    /** Return type description */
+    returns: z
+        .object({
+        type: z.string(),
+        description: z.string().optional(),
+    })
+        .optional(),
+    /** Required capabilities to perform this action */
+    requiredCapabilities: z.array(z.string()).optional(),
+    /** Side effects of this action */
+    sideEffects: z.array(z.string()).optional(),
+    /** Whether this action is destructive (defaults to false if not specified) */
+    destructive: z.boolean().optional(),
+});
+// =============================================================================
+// Agent Relation
+// =============================================================================
+/**
+ * A relationship to another entity
+ */
+export const AgentRelationSchema = z.object({
+    /** Relationship type */
+    type: z.enum([
+        'parent', // This entity is a child of target
+        'child', // This entity is a parent of target
+        'sibling', // Same level as target
+        'reference', // References target
+        'dependency', // Depends on target
+        'related', // Generally related
+    ]),
+    /** Target entity ID */
+    targetId: z.string(),
+    /** Target entity type */
+    targetType: z.string(),
+    /** Relationship weight (0-1, for relevance) */
+    weight: z.number().min(0).max(1).default(1),
+    /** Additional metadata */
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+// =============================================================================
+// Agent Representation
+// =============================================================================
+/**
+ * How an entity appears to AI agents.
+ *
+ * NOTE: This is metadata that describes how agents SHOULD interact.
+ * Actual enforcement happens at runtime in @revealui/actions.
+ */
+export const AgentRepresentationSchema = z.object({
+    /** Semantic type for agent reasoning */
+    semanticType: z.string(),
+    /** Semantic embedding (for similarity search) */
+    embedding: EmbeddingSchema.optional(),
+    /** Structured constraints the agent must respect */
+    constraints: z.array(AgentConstraintSchema).optional(),
+    /** Available actions the agent can take */
+    actions: z.array(AgentActionDefinitionSchema).optional(),
+    /** Relationships to other entities (for graph reasoning) */
+    relations: z.array(AgentRelationSchema).optional(),
+    /** Metadata for retrieval/search */
+    metadata: z.record(z.string(), z.unknown()).optional(),
+    /** Keywords for search/matching */
+    keywords: z.array(z.string()).optional(),
+    /** Priority/importance score (0-1) */
+    priority: z.number().min(0).max(1).optional(),
+});
+// =============================================================================
+// Dual Entity
+// =============================================================================
+/**
+ * Base schema for all RevealUI entities with dual representation
+ */
+export const DualEntitySchema = z.object({
+    /** Unique identifier */
+    id: z.string(),
+    /** Schema version for migrations */
+    version: z.number().int().default(REPRESENTATION_SCHEMA_VERSION),
+    /** Human-facing representation */
+    human: HumanRepresentationSchema.optional(),
+    /** Agent-facing representation */
+    agent: AgentRepresentationSchema.optional(),
+    /** ISO timestamp of creation */
+    createdAt: z.string().datetime(),
+    /** ISO timestamp of last update */
+    updatedAt: z.string().datetime(),
+});
+// =============================================================================
+// Translation Utilities
+// =============================================================================
+/**
+ * Generates a human representation from structured data
+ */
+export function toHumanRepresentation(data) {
+    return {
+        label: data.name || data.title || 'Untitled',
+        description: data.description,
+        preview: data.description?.slice(0, 100),
+        icon: data.icon,
+        color: data.color,
+    };
+}
+/**
+ * Generates a basic agent representation
+ */
+export function toAgentRepresentation(semanticType, options) {
+    return {
+        semanticType,
+        ...options,
+    };
+}
+/**
+ * Creates timestamps for new entities
+ */
+export function createTimestamps() {
+    const now = new Date().toISOString();
+    return { createdAt: now, updatedAt: now };
+}
+/**
+ * Updates the updatedAt timestamp
+ */
+export function updateTimestamp() {
+    return { updatedAt: new Date().toISOString() };
+}
+/**
+ * Creates a new version of an entity (for versioned updates)
+ */
+export function incrementVersion(currentVersion) {
+    return currentVersion + 1;
+}
+//# sourceMappingURL=index.js.map

package/dist/representation/index.js.map

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

package/package.json

@@ -0,0 +1,117 @@
+{
+  "name": "@revealui/contracts",
+  "version": "1.0.0",
+  "description": "Unified contracts package for RevealUI - schemas, validation, and type safety across the stack",
+  "keywords": [
+    "contracts",
+    "revealui",
+    "schema",
+    "typescript",
+    "validation",
+    "zod"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "drizzle-zod": "^0.8.3",
+    "zod": "^4.3.5",
+    "@revealui/db": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18",
+    "dev": "0.0.1"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./foundation": {
+      "types": "./dist/foundation/index.d.ts",
+      "import": "./dist/foundation/index.js"
+    },
+    "./representation": {
+      "types": "./dist/representation/index.d.ts",
+      "import": "./dist/representation/index.js"
+    },
+    "./entities": {
+      "types": "./dist/entities/index.d.ts",
+      "import": "./dist/entities/index.js"
+    },
+    "./content": {
+      "types": "./dist/content/index.d.ts",
+      "import": "./dist/content/index.js"
+    },
+    "./cms": {
+      "types": "./dist/cms/index.d.ts",
+      "import": "./dist/cms/index.js"
+    },
+    "./agents": {
+      "types": "./dist/agents/index.d.ts",
+      "import": "./dist/agents/index.js"
+    },
+    "./database": {
+      "types": "./dist/database/index.d.ts",
+      "import": "./dist/database/index.js"
+    },
+    "./actions": {
+      "types": "./dist/actions/index.d.ts",
+      "import": "./dist/actions/index.js"
+    },
+    "./core": {
+      "types": "./dist/cms/index.d.ts",
+      "import": "./dist/cms/index.js"
+    },
+    "./core/contracts": {
+      "types": "./dist/cms/index.d.ts",
+      "import": "./dist/cms/index.js"
+    },
+    "./blocks": {
+      "types": "./dist/content/index.d.ts",
+      "import": "./dist/content/index.js"
+    },
+    "./generated": {
+      "types": "./dist/generated/database.d.ts",
+      "import": "./dist/generated/database.js"
+    },
+    "./generated/database": {
+      "types": "./dist/generated/database.d.ts",
+      "import": "./dist/generated/database.js"
+    },
+    "./generated/zod-schemas": {
+      "types": "./dist/generated/zod-schemas.d.ts",
+      "import": "./dist/generated/zod-schemas.js"
+    },
+    "./generated/contracts": {
+      "types": "./dist/generated/contracts.d.ts",
+      "import": "./dist/generated/contracts.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0",
+    "@revealui/db": "0.2.0"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch",
+    "lint": "biome check .",
+    "lint:eslint": "eslint .",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}