@revealui/contracts 1.0.0

package/dist/entities/user.d.ts

@@ -0,0 +1,336 @@
+/**
+ * User Schema
+ *
+ * Users can be humans or agents. Both are first-class citizens in RevealUI.
+ * Humans interact through visual interfaces; agents through structured APIs.
+ * Both operate on the same underlying data with full audit trails.
+ *
+ * This schema extends the auto-generated UsersSelectSchema from the database
+ * and adds dual representation (human + agent views) and computed fields.
+ */
+import { z } from 'zod/v4';
+export declare const USER_SCHEMA_VERSION = 1;
+export declare const UserTypeSchema: z.ZodEnum<{
+    human: "human";
+    agent: "agent";
+    system: "system";
+}>;
+export type UserType = z.infer<typeof UserTypeSchema>;
+export declare const UserRoleSchema: z.ZodEnum<{
+    agent: "agent";
+    admin: "admin";
+    editor: "editor";
+    viewer: "viewer";
+    owner: "owner";
+    contributor: "contributor";
+}>;
+export type UserRole = z.infer<typeof UserRoleSchema>;
+export declare const UserStatusSchema: z.ZodEnum<{
+    active: "active";
+    suspended: "suspended";
+    deleted: "deleted";
+    pending: "pending";
+}>;
+export type UserStatus = z.infer<typeof UserStatusSchema>;
+export declare const UserPreferencesSchema: z.ZodObject<{
+    theme: z.ZodDefault<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+        system: "system";
+    }>>;
+    language: z.ZodDefault<z.ZodString>;
+    timezone: z.ZodDefault<z.ZodString>;
+    notifications: z.ZodOptional<z.ZodObject<{
+        email: z.ZodDefault<z.ZodBoolean>;
+        push: z.ZodDefault<z.ZodBoolean>;
+        inApp: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    editor: z.ZodOptional<z.ZodObject<{
+        fontSize: z.ZodDefault<z.ZodNumber>;
+        tabSize: z.ZodDefault<z.ZodNumber>;
+        wordWrap: z.ZodDefault<z.ZodBoolean>;
+        autoSave: z.ZodDefault<z.ZodBoolean>;
+        autoSaveIntervalMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    ai: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        autoSuggest: z.ZodDefault<z.ZodBoolean>;
+        voiceEnabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type UserPreferences = z.infer<typeof UserPreferencesSchema>;
+/**
+ * User schema with dual representation and computed fields.
+ *
+ * NOTE: The auto-generated UsersSelectSchema from packages/db is available
+ * and can be used to extend this schema in the future for tighter integration.
+ * For now, we maintain the existing schema structure for backward compatibility.
+ *
+ * Future refactoring: Extend UsersSelectSchema.merge(DualEntitySchema)
+ */
+export declare const UserSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodDefault<z.ZodNumber>;
+    human: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+        preview: z.ZodOptional<z.ZodString>;
+        suggestions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        helpText: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    agent: z.ZodOptional<z.ZodObject<{
+        semanticType: z.ZodString;
+        embedding: z.ZodOptional<z.ZodObject<{
+            model: z.ZodString;
+            vector: z.ZodArray<z.ZodNumber>;
+            dimension: z.ZodNumber;
+            generatedAt: z.ZodString;
+        }, z.core.$strip>>;
+        constraints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                custom: "custom";
+                readonly: "readonly";
+                pattern: "pattern";
+                required: "required";
+                immutable: "immutable";
+                range: "range";
+                dependency: "dependency";
+                capability: "capability";
+                permission: "permission";
+            }>;
+            field: z.ZodOptional<z.ZodString>;
+            params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            params: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodString;
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                default: z.ZodOptional<z.ZodUnknown>;
+                enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            returns: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sideEffects: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            destructive: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                dependency: "dependency";
+                parent: "parent";
+                child: "child";
+                sibling: "sibling";
+                reference: "reference";
+                related: "related";
+            }>;
+            targetId: z.ZodString;
+            targetType: z.ZodString;
+            weight: z.ZodDefault<z.ZodNumber>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        priority: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    schemaVersion: z.ZodDefault<z.ZodNumber>;
+    type: z.ZodEnum<{
+        human: "human";
+        agent: "agent";
+        system: "system";
+    }>;
+    status: z.ZodDefault<z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        deleted: "deleted";
+        pending: "pending";
+    }>>;
+    email: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    avatarUrl: z.ZodOptional<z.ZodURL>;
+    role: z.ZodEnum<{
+        agent: "agent";
+        admin: "admin";
+        editor: "editor";
+        viewer: "viewer";
+        owner: "owner";
+        contributor: "contributor";
+    }>;
+    agentModel: z.ZodOptional<z.ZodString>;
+    agentCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    agentConfig: z.ZodOptional<z.ZodObject<{
+        systemPrompt: z.ZodOptional<z.ZodString>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    preferences: z.ZodOptional<z.ZodObject<{
+        theme: z.ZodDefault<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+            system: "system";
+        }>>;
+        language: z.ZodDefault<z.ZodString>;
+        timezone: z.ZodDefault<z.ZodString>;
+        notifications: z.ZodOptional<z.ZodObject<{
+            email: z.ZodDefault<z.ZodBoolean>;
+            push: z.ZodDefault<z.ZodBoolean>;
+            inApp: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        editor: z.ZodOptional<z.ZodObject<{
+            fontSize: z.ZodDefault<z.ZodNumber>;
+            tabSize: z.ZodDefault<z.ZodNumber>;
+            wordWrap: z.ZodDefault<z.ZodBoolean>;
+            autoSave: z.ZodDefault<z.ZodBoolean>;
+            autoSaveIntervalMs: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        ai: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            autoSuggest: z.ZodDefault<z.ZodBoolean>;
+            voiceEnabled: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    lastActiveAt: z.ZodOptional<z.ZodString>;
+    emailVerified: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type User = z.infer<typeof UserSchema>;
+/**
+ * User creation input - defines required fields for creating a new user
+ * Based on the auto-generated UsersInsertSchema structure
+ */
+export declare const CreateUserInputSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        human: "human";
+        agent: "agent";
+        system: "system";
+    }>;
+    email: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    role: z.ZodEnum<{
+        agent: "agent";
+        admin: "admin";
+        editor: "editor";
+        viewer: "viewer";
+        owner: "owner";
+        contributor: "contributor";
+    }>;
+    avatarUrl: z.ZodOptional<z.ZodURL>;
+    agentModel: z.ZodOptional<z.ZodString>;
+    agentCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    agentConfig: z.ZodOptional<z.ZodObject<{
+        systemPrompt: z.ZodOptional<z.ZodString>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    preferences: z.ZodOptional<z.ZodObject<{
+        theme: z.ZodDefault<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+            system: "system";
+        }>>;
+        language: z.ZodDefault<z.ZodString>;
+        timezone: z.ZodDefault<z.ZodString>;
+        notifications: z.ZodOptional<z.ZodObject<{
+            email: z.ZodDefault<z.ZodBoolean>;
+            push: z.ZodDefault<z.ZodBoolean>;
+            inApp: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        editor: z.ZodOptional<z.ZodObject<{
+            fontSize: z.ZodDefault<z.ZodNumber>;
+            tabSize: z.ZodDefault<z.ZodNumber>;
+            wordWrap: z.ZodDefault<z.ZodBoolean>;
+            autoSave: z.ZodDefault<z.ZodBoolean>;
+            autoSaveIntervalMs: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        ai: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            autoSuggest: z.ZodDefault<z.ZodBoolean>;
+            voiceEnabled: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CreateUserInput = z.infer<typeof CreateUserInputSchema>;
+/**
+ * Creates a new user with dual representation
+ */
+export declare function createUser(id: string, input: CreateUserInput): User;
+export declare const UpdateUserInputSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    avatarUrl: z.ZodOptional<z.ZodURL>;
+    role: z.ZodOptional<z.ZodEnum<{
+        agent: "agent";
+        admin: "admin";
+        editor: "editor";
+        viewer: "viewer";
+        owner: "owner";
+        contributor: "contributor";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        deleted: "deleted";
+        pending: "pending";
+    }>>;
+    preferences: z.ZodOptional<z.ZodObject<{
+        theme: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+            system: "system";
+        }>>>;
+        language: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        timezone: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        notifications: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            email: z.ZodDefault<z.ZodBoolean>;
+            push: z.ZodDefault<z.ZodBoolean>;
+            inApp: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        editor: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            fontSize: z.ZodDefault<z.ZodNumber>;
+            tabSize: z.ZodDefault<z.ZodNumber>;
+            wordWrap: z.ZodDefault<z.ZodBoolean>;
+            autoSave: z.ZodDefault<z.ZodBoolean>;
+            autoSaveIntervalMs: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        ai: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            autoSuggest: z.ZodDefault<z.ZodBoolean>;
+            voiceEnabled: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    agentConfig: z.ZodOptional<z.ZodObject<{
+        systemPrompt: z.ZodOptional<z.ZodString>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type UpdateUserInput = z.infer<typeof UpdateUserInputSchema>;
+export declare const SessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodDefault<z.ZodNumber>;
+    userId: z.ZodString;
+    tokenHash: z.ZodString;
+    expiresAt: z.ZodString;
+    userAgent: z.ZodOptional<z.ZodString>;
+    ipAddress: z.ZodOptional<z.ZodString>;
+    persistent: z.ZodDefault<z.ZodBoolean>;
+    createdAt: z.ZodString;
+    lastActivityAt: z.ZodString;
+}, z.core.$strip>;
+export type Session = z.infer<typeof SessionSchema>;
+/**
+ * Creates a new session
+ */
+export declare function createSession(id: string, userId: string, tokenHash: string, expiresAt: Date, options?: {
+    userAgent?: string;
+    ipAddress?: string;
+    persistent?: boolean;
+}): Session;
+//# sourceMappingURL=user.d.ts.map

package/dist/entities/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/entities/user.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAgB1B,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAMpC,eAAO,MAAM,cAAc;;;;EAIzB,CAAA;AACF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD,eAAO,MAAM,cAAc;;;;;;;EAOzB,CAAA;AACF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD,eAAO,MAAM,gBAAgB;;;;;EAK3B,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAMzD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;iBAsChC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAMnE;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6CrB,CAAA;AAEF,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA;AAM7C;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgBhC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CA6CnE;AAMD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAahC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAMnE,eAAO,MAAM,aAAa;;;;;;;;;;;iBA8BxB,CAAA;AAEF,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEnD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,IAAI,EACf,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,GACA,OAAO,CAcT"}

package/dist/entities/user.js

@@ -0,0 +1,255 @@
+/**
+ * User Schema
+ *
+ * Users can be humans or agents. Both are first-class citizens in RevealUI.
+ * Humans interact through visual interfaces; agents through structured APIs.
+ * Both operate on the same underlying data with full audit trails.
+ *
+ * This schema extends the auto-generated UsersSelectSchema from the database
+ * and adds dual representation (human + agent views) and computed fields.
+ */
+import { z } from 'zod/v4';
+import { createTimestamps, DualEntitySchema, REPRESENTATION_SCHEMA_VERSION, toAgentRepresentation, toHumanRepresentation, } from '../representation/index.js';
+// NOTE: Auto-generated schemas available for future use:
+// import { UsersSelectSchema, UsersInsertSchema } from '../generated/zod-schemas.js'
+// These can be used to extend/compose with business logic in the future
+// =============================================================================
+// Schema Version
+// =============================================================================
+export const USER_SCHEMA_VERSION = 1;
+// =============================================================================
+// User Types
+// =============================================================================
+export const UserTypeSchema = z.enum([
+    'human', // A human user
+    'agent', // An AI agent
+    'system', // System user (for automated tasks)
+]);
+export const UserRoleSchema = z.enum([
+    'owner', // Full control
+    'admin', // Administrative access
+    'editor', // Can edit content
+    'viewer', // Read-only access
+    'agent', // AI agent role
+    'contributor', // Can suggest changes
+]);
+export const UserStatusSchema = z.enum([
+    'active', // Normal operation
+    'suspended', // Temporarily disabled
+    'deleted', // Soft deleted
+    'pending', // Awaiting verification
+]);
+// =============================================================================
+// User Preferences
+// =============================================================================
+export const UserPreferencesSchema = z.object({
+    /** UI theme */
+    theme: z.enum(['light', 'dark', 'system']).default('system'),
+    /** Preferred language */
+    language: z.string().default('en'),
+    /** Timezone */
+    timezone: z.string().default('UTC'),
+    /** Enable notifications */
+    notifications: z
+        .object({
+        email: z.boolean().default(true),
+        push: z.boolean().default(false),
+        inApp: z.boolean().default(true),
+    })
+        .optional(),
+    /** Editor preferences */
+    editor: z
+        .object({
+        fontSize: z.number().int().min(10).max(24).default(14),
+        tabSize: z.number().int().min(1).max(8).default(2),
+        wordWrap: z.boolean().default(true),
+        autoSave: z.boolean().default(true),
+        autoSaveIntervalMs: z.number().int().min(1000).default(5000),
+    })
+        .optional(),
+    /** AI assistance preferences */
+    ai: z
+        .object({
+        enabled: z.boolean().default(true),
+        autoSuggest: z.boolean().default(true),
+        voiceEnabled: z.boolean().default(false),
+    })
+        .optional(),
+});
+// =============================================================================
+// User Schema (extends auto-generated base)
+// =============================================================================
+/**
+ * User schema with dual representation and computed fields.
+ *
+ * NOTE: The auto-generated UsersSelectSchema from packages/db is available
+ * and can be used to extend this schema in the future for tighter integration.
+ * For now, we maintain the existing schema structure for backward compatibility.
+ *
+ * Future refactoring: Extend UsersSelectSchema.merge(DualEntitySchema)
+ */
+export const UserSchema = DualEntitySchema.extend({
+    /** Schema version for migrations */
+    schemaVersion: z.number().int().default(USER_SCHEMA_VERSION),
+    /** User type: human, agent, or system */
+    type: UserTypeSchema,
+    /** User status */
+    status: UserStatusSchema.default('active'),
+    /** Email (for humans) or identifier (for agents) */
+    email: z.string().email().optional(),
+    /** Display name */
+    name: z.string().min(1).max(100),
+    /** Avatar URL */
+    avatarUrl: z.url().optional(),
+    /** User's role */
+    role: UserRoleSchema,
+    /** For agents: the model/version identifier */
+    agentModel: z.string().optional(),
+    /** For agents: capabilities this agent has */
+    agentCapabilities: z.array(z.string()).optional(),
+    /** For agents: configuration */
+    agentConfig: z
+        .object({
+        systemPrompt: z.string().optional(),
+        temperature: z.number().min(0).max(2).optional(),
+        maxTokens: z.number().int().positive().optional(),
+    })
+        .optional(),
+    /** User preferences (human-native settings) */
+    preferences: UserPreferencesSchema.optional(),
+    /** Last active timestamp */
+    lastActiveAt: z.string().datetime().optional(),
+    /** Email verified */
+    emailVerified: z.boolean().default(false),
+});
+// =============================================================================
+// User Creation
+// =============================================================================
+/**
+ * User creation input - defines required fields for creating a new user
+ * Based on the auto-generated UsersInsertSchema structure
+ */
+export const CreateUserInputSchema = z.object({
+    type: UserTypeSchema,
+    email: z.string().email().optional(),
+    name: z.string().min(1).max(100),
+    role: UserRoleSchema,
+    avatarUrl: z.url().optional(),
+    agentModel: z.string().optional(),
+    agentCapabilities: z.array(z.string()).optional(),
+    agentConfig: z
+        .object({
+        systemPrompt: z.string().optional(),
+        temperature: z.number().min(0).max(2).optional(),
+        maxTokens: z.number().int().positive().optional(),
+    })
+        .optional(),
+    preferences: UserPreferencesSchema.optional(),
+});
+/**
+ * Creates a new user with dual representation
+ */
+export function createUser(id, input) {
+    const timestamps = createTimestamps();
+    return {
+        id,
+        version: REPRESENTATION_SCHEMA_VERSION,
+        schemaVersion: USER_SCHEMA_VERSION,
+        type: input.type,
+        status: 'active',
+        email: input.email,
+        name: input.name,
+        role: input.role,
+        avatarUrl: input.avatarUrl,
+        agentModel: input.agentModel,
+        agentCapabilities: input.agentCapabilities,
+        agentConfig: input.agentConfig,
+        preferences: input.preferences,
+        emailVerified: false,
+        human: toHumanRepresentation({
+            name: input.name,
+            description: input.type === 'agent'
+                ? `AI Agent: ${input.agentModel || 'Unknown model'}`
+                : `User: ${input.email || input.name}`,
+            icon: input.type === 'agent' ? 'robot' : 'user',
+        }),
+        agent: toAgentRepresentation('user', {
+            constraints: input.type === 'agent'
+                ? [
+                    {
+                        type: 'capability',
+                        params: { allowed: input.agentCapabilities || [] },
+                        message: 'Agent can only perform actions within its capabilities',
+                    },
+                ]
+                : undefined,
+            metadata: {
+                userType: input.type,
+                role: input.role,
+            },
+            keywords: [input.type, input.role, input.name.toLowerCase()],
+        }),
+        ...timestamps,
+    };
+}
+// =============================================================================
+// User Update
+// =============================================================================
+export const UpdateUserInputSchema = z.object({
+    name: z.string().min(1).max(100).optional(),
+    avatarUrl: z.url().optional(),
+    role: UserRoleSchema.optional(),
+    status: UserStatusSchema.optional(),
+    preferences: UserPreferencesSchema.partial().optional(),
+    agentConfig: z
+        .object({
+        systemPrompt: z.string().optional(),
+        temperature: z.number().min(0).max(2).optional(),
+        maxTokens: z.number().int().positive().optional(),
+    })
+        .optional(),
+});
+// =============================================================================
+// Session Schema
+// =============================================================================
+export const SessionSchema = z.object({
+    /** Session ID */
+    id: z.string(),
+    /** Schema version */
+    version: z.number().int().default(USER_SCHEMA_VERSION),
+    /** User who owns this session */
+    userId: z.string(),
+    /** Session token (hashed) */
+    tokenHash: z.string(),
+    /** When the session expires */
+    expiresAt: z.string().datetime(),
+    /** Device/client info */
+    userAgent: z.string().optional(),
+    /** IP address (for security) */
+    ipAddress: z.string().optional(),
+    /** Whether this is a long-lived session (remember me) */
+    persistent: z.boolean().default(false),
+    /** Creation timestamp */
+    createdAt: z.string().datetime(),
+    /** Last activity timestamp */
+    lastActivityAt: z.string().datetime(),
+});
+/**
+ * Creates a new session
+ */
+export function createSession(id, userId, tokenHash, expiresAt, options) {
+    const now = new Date().toISOString();
+    return {
+        id,
+        version: USER_SCHEMA_VERSION,
+        userId,
+        tokenHash,
+        expiresAt: expiresAt.toISOString(),
+        userAgent: options?.userAgent,
+        ipAddress: options?.ipAddress,
+        persistent: options?.persistent ?? false,
+        createdAt: now,
+        lastActivityAt: now,
+    };
+}
+//# sourceMappingURL=user.js.map

package/dist/entities/user.js.map

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