@revealui/contracts 1.0.0

package/dist/entities/agent-memory.d.ts

@@ -0,0 +1,661 @@
+/**
+ * AgentMemory Entity Contract
+ *
+ * Manages long-term agent memories with semantic search, verification workflow,
+ * and multi-source tracking. Memories can be facts, preferences, decisions,
+ * feedback, examples, corrections, skills, or warnings.
+ *
+ * Business Rules:
+ * - Memory types: fact, preference, decision, feedback, example, correction, skill, warning
+ * - Embeddings are 1536 dimensions (OpenAI ada-002 format)
+ * - Source tracking required (conversation, user input, observation, etc.)
+ * - Access tracking for importance scoring
+ * - Verification workflow (verified, verifiedBy, verifiedAt)
+ * - Optional expiration for time-sensitive memories
+ * - Scoped to site and/or agent
+ */
+import { z } from 'zod/v4';
+export declare const AGENT_MEMORY_SCHEMA_VERSION = 1;
+export declare const MEMORY_TYPES: readonly ["fact", "preference", "decision", "feedback", "example", "correction", "skill", "warning"];
+export type MemoryType = (typeof MEMORY_TYPES)[number];
+export declare const SOURCE_TYPES: readonly ["conversation", "user_input", "observation", "tool_use", "feedback", "correction", "inference", "import"];
+export type SourceType = (typeof SOURCE_TYPES)[number];
+export declare const MEMORY_EMBEDDING_CONFIG: {
+    readonly DIMENSIONS: 1536;
+    readonly MIN_VALUE: -1;
+    readonly MAX_VALUE: 1;
+};
+export declare const ACCESS_THRESHOLDS: {
+    readonly FREQUENTLY_ACCESSED: 10;
+    readonly RARELY_ACCESSED: 2;
+    readonly STALE_DAYS: 30;
+};
+export declare const IMPORTANCE_LEVELS: {
+    readonly CRITICAL: 1;
+    readonly HIGH: 0.8;
+    readonly MEDIUM: 0.5;
+    readonly LOW: 0.3;
+    readonly MINIMAL: 0.1;
+};
+/**
+ * Memory source schema with provenance tracking
+ */
+export declare const MemorySourceSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        feedback: "feedback";
+        correction: "correction";
+        conversation: "conversation";
+        user_input: "user_input";
+        observation: "observation";
+        tool_use: "tool_use";
+        inference: "inference";
+        import: "import";
+    }>;
+    conversationId: z.ZodOptional<z.ZodString>;
+    messageId: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodOptional<z.ZodDate>;
+    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type MemorySource = z.infer<typeof MemorySourceSchema>;
+/**
+ * Embedding metadata schema
+ */
+export declare const EmbeddingMetadataSchema: z.ZodObject<{
+    model: z.ZodString;
+    dimensions: z.ZodDefault<z.ZodNumber>;
+    generatedAt: z.ZodDate;
+    version: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type EmbeddingMetadata = z.infer<typeof EmbeddingMetadataSchema>;
+/**
+ * Memory metadata schema
+ */
+export declare const MemoryMetadataSchema: z.ZodObject<{
+    importance: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    category: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    relatedMemories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type MemoryMetadata = z.infer<typeof MemoryMetadataSchema>;
+/**
+ * Embedding vector schema (1536 dimensions)
+ */
+export declare const MemoryEmbeddingVectorSchema: z.ZodArray<z.ZodNumber>;
+export type MemoryEmbeddingVector = z.infer<typeof MemoryEmbeddingVectorSchema>;
+/**
+ * Agent Memory object schema
+ */
+export declare const AgentMemoryObjectSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodDefault<z.ZodNumber>;
+    content: z.ZodString;
+    type: z.ZodEnum<{
+        fact: "fact";
+        preference: "preference";
+        decision: "decision";
+        feedback: "feedback";
+        example: "example";
+        correction: "correction";
+        skill: "skill";
+        warning: "warning";
+    }>;
+    source: z.ZodObject<{
+        type: z.ZodEnum<{
+            feedback: "feedback";
+            correction: "correction";
+            conversation: "conversation";
+            user_input: "user_input";
+            observation: "observation";
+            tool_use: "tool_use";
+            inference: "inference";
+            import: "import";
+        }>;
+        conversationId: z.ZodOptional<z.ZodString>;
+        messageId: z.ZodOptional<z.ZodString>;
+        userId: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodDate>;
+        context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    embedding: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber>>>;
+    embeddingMetadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        model: z.ZodString;
+        dimensions: z.ZodDefault<z.ZodNumber>;
+        generatedAt: z.ZodDate;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    metadata: z.ZodDefault<z.ZodObject<{
+        importance: z.ZodOptional<z.ZodNumber>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        category: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        relatedMemories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    accessCount: z.ZodDefault<z.ZodNumber>;
+    accessedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    verified: z.ZodDefault<z.ZodBoolean>;
+    verifiedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    verifiedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    siteId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodDate;
+    expiresAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+}, z.core.$strip>;
+/**
+ * Agent Memory schema with validation rules
+ */
+export declare const AgentMemoryBaseSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodDefault<z.ZodNumber>;
+    content: z.ZodString;
+    type: z.ZodEnum<{
+        fact: "fact";
+        preference: "preference";
+        decision: "decision";
+        feedback: "feedback";
+        example: "example";
+        correction: "correction";
+        skill: "skill";
+        warning: "warning";
+    }>;
+    source: z.ZodObject<{
+        type: z.ZodEnum<{
+            feedback: "feedback";
+            correction: "correction";
+            conversation: "conversation";
+            user_input: "user_input";
+            observation: "observation";
+            tool_use: "tool_use";
+            inference: "inference";
+            import: "import";
+        }>;
+        conversationId: z.ZodOptional<z.ZodString>;
+        messageId: z.ZodOptional<z.ZodString>;
+        userId: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodDate>;
+        context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    embedding: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber>>>;
+    embeddingMetadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        model: z.ZodString;
+        dimensions: z.ZodDefault<z.ZodNumber>;
+        generatedAt: z.ZodDate;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    metadata: z.ZodDefault<z.ZodObject<{
+        importance: z.ZodOptional<z.ZodNumber>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        category: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        relatedMemories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    accessCount: z.ZodDefault<z.ZodNumber>;
+    accessedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    verified: z.ZodDefault<z.ZodBoolean>;
+    verifiedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    verifiedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    siteId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodDate;
+    expiresAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+}, z.core.$strip>;
+export declare const AgentMemorySchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodDefault<z.ZodNumber>;
+    content: z.ZodString;
+    type: z.ZodEnum<{
+        fact: "fact";
+        preference: "preference";
+        decision: "decision";
+        feedback: "feedback";
+        example: "example";
+        correction: "correction";
+        skill: "skill";
+        warning: "warning";
+    }>;
+    source: z.ZodObject<{
+        type: z.ZodEnum<{
+            feedback: "feedback";
+            correction: "correction";
+            conversation: "conversation";
+            user_input: "user_input";
+            observation: "observation";
+            tool_use: "tool_use";
+            inference: "inference";
+            import: "import";
+        }>;
+        conversationId: z.ZodOptional<z.ZodString>;
+        messageId: z.ZodOptional<z.ZodString>;
+        userId: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodDate>;
+        context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    embedding: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber>>>;
+    embeddingMetadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        model: z.ZodString;
+        dimensions: z.ZodDefault<z.ZodNumber>;
+        generatedAt: z.ZodDate;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    metadata: z.ZodDefault<z.ZodObject<{
+        importance: z.ZodOptional<z.ZodNumber>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        category: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        relatedMemories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    accessCount: z.ZodDefault<z.ZodNumber>;
+    accessedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    verified: z.ZodDefault<z.ZodBoolean>;
+    verifiedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    verifiedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    siteId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodDate;
+    expiresAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+}, z.core.$strip>;
+/**
+ * Schema for creating new agent memories
+ */
+export declare const AgentMemoryInsertSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodNumber>;
+    type: z.ZodEnum<{
+        fact: "fact";
+        preference: "preference";
+        decision: "decision";
+        feedback: "feedback";
+        example: "example";
+        correction: "correction";
+        skill: "skill";
+        warning: "warning";
+    }>;
+    metadata: z.ZodDefault<z.ZodObject<{
+        importance: z.ZodOptional<z.ZodNumber>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        category: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        relatedMemories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    embedding: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber>>>;
+    id: z.ZodString;
+    content: z.ZodString;
+    source: z.ZodObject<{
+        type: z.ZodEnum<{
+            feedback: "feedback";
+            correction: "correction";
+            conversation: "conversation";
+            user_input: "user_input";
+            observation: "observation";
+            tool_use: "tool_use";
+            inference: "inference";
+            import: "import";
+        }>;
+        conversationId: z.ZodOptional<z.ZodString>;
+        messageId: z.ZodOptional<z.ZodString>;
+        userId: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodDate>;
+        context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    expiresAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    siteId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    verified: z.ZodDefault<z.ZodBoolean>;
+    embeddingMetadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        model: z.ZodString;
+        dimensions: z.ZodDefault<z.ZodNumber>;
+        generatedAt: z.ZodDate;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    verifiedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    verifiedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    createdAt: z.ZodOptional<z.ZodDate>;
+    accessCount: z.ZodOptional<z.ZodNumber>;
+    accessedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+}, z.core.$strip>;
+export type AgentMemory = z.infer<typeof AgentMemorySchema>;
+export type AgentMemoryInsert = z.infer<typeof AgentMemoryInsertSchema>;
+/**
+ * Check if memory is a fact
+ */
+export declare function isFactMemory(memory: AgentMemory): boolean;
+/**
+ * Check if memory is a preference
+ */
+export declare function isPreferenceMemory(memory: AgentMemory): boolean;
+/**
+ * Check if memory is a decision
+ */
+export declare function isDecisionMemory(memory: AgentMemory): boolean;
+/**
+ * Check if memory is feedback
+ */
+export declare function isFeedbackMemory(memory: AgentMemory): boolean;
+/**
+ * Check if memory is a correction
+ */
+export declare function isCorrectionMemory(memory: AgentMemory): boolean;
+/**
+ * Check if memory is a warning
+ */
+export declare function isWarningMemory(memory: AgentMemory): boolean;
+/**
+ * Check if memory is verified
+ */
+export declare function isVerified(memory: AgentMemory): boolean;
+/**
+ * Check if memory needs verification
+ */
+export declare function needsVerification(memory: AgentMemory): boolean;
+/**
+ * Create verification update
+ */
+export declare function createVerification(verifiedBy: string): Partial<AgentMemory>;
+/**
+ * Revoke verification
+ */
+export declare function revokeVerification(): Partial<AgentMemory>;
+/**
+ * Check if memory is expired
+ */
+export declare function isExpired(memory: AgentMemory): boolean;
+/**
+ * Check if memory is permanent (no expiration)
+ */
+export declare function isPermanent(memory: AgentMemory): boolean;
+/**
+ * Calculate time until expiration in milliseconds
+ */
+export declare function getTimeUntilExpiration(memory: AgentMemory): number | null;
+/**
+ * Check if memory is near expiration (< 24 hours)
+ */
+export declare function isNearExpiration(memory: AgentMemory, thresholdHours?: number): boolean;
+/**
+ * Create expiration date from duration in days
+ */
+export declare function createExpirationDate(daysFromNow: number): Date;
+/**
+ * Check if memory is frequently accessed
+ */
+export declare function isFrequentlyAccessed(memory: AgentMemory): boolean;
+/**
+ * Check if memory is rarely accessed
+ */
+export declare function isRarelyAccessed(memory: AgentMemory): boolean;
+/**
+ * Check if memory is stale (not accessed recently)
+ */
+export declare function isStale(memory: AgentMemory, thresholdDays?: 30): boolean;
+/**
+ * Increment access count and update timestamp
+ */
+export declare function recordAccess(): Partial<AgentMemory>;
+/**
+ * Get access frequency category
+ */
+export declare function getAccessFrequency(memory: AgentMemory): 'high' | 'medium' | 'low';
+/**
+ * Get memory importance from metadata
+ */
+export declare function getImportance(memory: AgentMemory): number;
+/**
+ * Check if memory is critical importance
+ */
+export declare function isCriticalImportance(memory: AgentMemory): boolean;
+/**
+ * Get importance category
+ */
+export declare function getImportanceCategory(memory: AgentMemory): 'critical' | 'high' | 'medium' | 'low';
+/**
+ * Calculate composite relevance score
+ */
+export declare function calculateRelevanceScore(memory: AgentMemory): number;
+/**
+ * Check if memory has valid embedding
+ */
+export declare function hasValidEmbedding(memory: AgentMemory): boolean;
+/**
+ * Check if memory has embedding metadata
+ */
+export declare function hasEmbeddingMetadata(memory: AgentMemory): boolean;
+/**
+ * Check if memory is scoped to a site
+ */
+export declare function isSiteScoped(memory: AgentMemory): boolean;
+/**
+ * Check if memory is scoped to an agent
+ */
+export declare function isAgentScoped(memory: AgentMemory): boolean;
+/**
+ * Check if memory is global (not scoped)
+ */
+export declare function isGlobalMemory(memory: AgentMemory): boolean;
+/**
+ * Create agent memory insert data
+ */
+export declare function createAgentMemoryInsert(content: string, type: MemoryType, source: MemorySource, options?: {
+    id?: string;
+    embedding?: number[];
+    embeddingMetadata?: EmbeddingMetadata;
+    metadata?: MemoryMetadata;
+    siteId?: string;
+    agentId?: string;
+    expiresAt?: Date;
+}): AgentMemoryInsert;
+/**
+ * Update memory with new data
+ */
+export declare function updateAgentMemory(updates: {
+    content?: string;
+    metadata?: MemoryMetadata;
+    embedding?: number[] | null;
+    embeddingMetadata?: EmbeddingMetadata | null;
+    expiresAt?: Date | null;
+}): Partial<AgentMemory>;
+/**
+ * Agent memory with computed fields for UI display
+ */
+export interface AgentMemoryWithComputed extends AgentMemory {
+    _computed: {
+        isExpired: boolean;
+        isPermanent: boolean;
+        isVerified: boolean;
+        needsVerification: boolean;
+        hasEmbedding: boolean;
+        embeddingValid: boolean;
+        accessFrequency: 'high' | 'medium' | 'low';
+        isStale: boolean;
+        importance: number;
+        importanceCategory: 'critical' | 'high' | 'medium' | 'low';
+        relevanceScore: number;
+        timeUntilExpiration: number | null;
+        isSiteScoped: boolean;
+        isAgentScoped: boolean;
+        isGlobal: boolean;
+    };
+}
+/**
+ * Convert agent memory to format with computed fields
+ */
+export declare function agentMemoryToHuman(memory: AgentMemory): AgentMemoryWithComputed;
+/**
+ * Agent memory with metadata for agent/API consumption
+ */
+export interface AgentMemoryAgent extends AgentMemory {
+    agentMetadata: {
+        expired: boolean;
+        permanent: boolean;
+        verified: boolean;
+        embeddingPresent: boolean;
+        embeddingDimensions: number | null;
+        accessCount: number;
+        lastAccessed: Date | null;
+        relevanceScore: number;
+        scope: 'site' | 'agent' | 'global';
+    };
+}
+/**
+ * Convert agent memory to agent-compatible format
+ */
+export declare function agentMemoryToAgent(memory: AgentMemory): AgentMemoryAgent;
+/**
+ * Zod schema for agent memory with computed fields
+ */
+export declare const AgentMemoryWithComputedSchema: z.ZodIntersection<z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodDefault<z.ZodNumber>;
+    content: z.ZodString;
+    type: z.ZodEnum<{
+        fact: "fact";
+        preference: "preference";
+        decision: "decision";
+        feedback: "feedback";
+        example: "example";
+        correction: "correction";
+        skill: "skill";
+        warning: "warning";
+    }>;
+    source: z.ZodObject<{
+        type: z.ZodEnum<{
+            feedback: "feedback";
+            correction: "correction";
+            conversation: "conversation";
+            user_input: "user_input";
+            observation: "observation";
+            tool_use: "tool_use";
+            inference: "inference";
+            import: "import";
+        }>;
+        conversationId: z.ZodOptional<z.ZodString>;
+        messageId: z.ZodOptional<z.ZodString>;
+        userId: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodDate>;
+        context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    embedding: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber>>>;
+    embeddingMetadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        model: z.ZodString;
+        dimensions: z.ZodDefault<z.ZodNumber>;
+        generatedAt: z.ZodDate;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    metadata: z.ZodDefault<z.ZodObject<{
+        importance: z.ZodOptional<z.ZodNumber>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        category: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        relatedMemories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    accessCount: z.ZodDefault<z.ZodNumber>;
+    accessedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    verified: z.ZodDefault<z.ZodBoolean>;
+    verifiedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    verifiedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    siteId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodDate;
+    expiresAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+}, z.core.$strip>, z.ZodObject<{
+    _computed: z.ZodObject<{
+        isExpired: z.ZodBoolean;
+        isPermanent: z.ZodBoolean;
+        isVerified: z.ZodBoolean;
+        needsVerification: z.ZodBoolean;
+        hasEmbedding: z.ZodBoolean;
+        embeddingValid: z.ZodBoolean;
+        accessFrequency: z.ZodEnum<{
+            high: "high";
+            low: "low";
+            medium: "medium";
+        }>;
+        isStale: z.ZodBoolean;
+        importance: z.ZodNumber;
+        importanceCategory: z.ZodEnum<{
+            high: "high";
+            low: "low";
+            medium: "medium";
+            critical: "critical";
+        }>;
+        relevanceScore: z.ZodNumber;
+        timeUntilExpiration: z.ZodNullable<z.ZodNumber>;
+        isSiteScoped: z.ZodBoolean;
+        isAgentScoped: z.ZodBoolean;
+        isGlobal: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>>;
+/**
+ * Zod schema for agent memory with agent metadata
+ */
+export declare const AgentMemoryAgentSchema: z.ZodIntersection<z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodDefault<z.ZodNumber>;
+    content: z.ZodString;
+    type: z.ZodEnum<{
+        fact: "fact";
+        preference: "preference";
+        decision: "decision";
+        feedback: "feedback";
+        example: "example";
+        correction: "correction";
+        skill: "skill";
+        warning: "warning";
+    }>;
+    source: z.ZodObject<{
+        type: z.ZodEnum<{
+            feedback: "feedback";
+            correction: "correction";
+            conversation: "conversation";
+            user_input: "user_input";
+            observation: "observation";
+            tool_use: "tool_use";
+            inference: "inference";
+            import: "import";
+        }>;
+        conversationId: z.ZodOptional<z.ZodString>;
+        messageId: z.ZodOptional<z.ZodString>;
+        userId: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodDate>;
+        context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    embedding: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber>>>;
+    embeddingMetadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        model: z.ZodString;
+        dimensions: z.ZodDefault<z.ZodNumber>;
+        generatedAt: z.ZodDate;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    metadata: z.ZodDefault<z.ZodObject<{
+        importance: z.ZodOptional<z.ZodNumber>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        category: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        relatedMemories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    accessCount: z.ZodDefault<z.ZodNumber>;
+    accessedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    verified: z.ZodDefault<z.ZodBoolean>;
+    verifiedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    verifiedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    siteId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodDate;
+    expiresAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+}, z.core.$strip>, z.ZodObject<{
+    agentMetadata: z.ZodObject<{
+        expired: z.ZodBoolean;
+        permanent: z.ZodBoolean;
+        verified: z.ZodBoolean;
+        embeddingPresent: z.ZodBoolean;
+        embeddingDimensions: z.ZodNullable<z.ZodNumber>;
+        accessCount: z.ZodNumber;
+        lastAccessed: z.ZodNullable<z.ZodDate>;
+        relevanceScore: z.ZodNumber;
+        scope: z.ZodEnum<{
+            agent: "agent";
+            site: "site";
+            global: "global";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>>;
+//# sourceMappingURL=agent-memory.d.ts.map

package/dist/entities/agent-memory.d.ts.map

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