@framers/agentos 0.6.29 → 0.7.0

package/dist/safety/validation/schema-primitives.js

@@ -0,0 +1,141 @@
+/**
+ * @fileoverview Shared Zod building blocks for LLM output schemas.
+ *
+ * Call sites compose domain-specific schemas from these primitives
+ * rather than duplicating enum definitions and field validators.
+ * The primitives file is intentionally small — it provides reusable
+ * atoms, not complete schemas for every use case.
+ *
+ * @example
+ * ```ts
+ * import { MemoryTypeEnum, ConfidenceScore, EntityArray } from '@framers/agentos/core/validation';
+ *
+ * const MySchema = z.object({
+ *   type: MemoryTypeEnum,
+ *   confidence: ConfidenceScore,
+ *   entities: EntityArray,
+ *   myCustomField: z.string(),
+ * });
+ * ```
+ *
+ * @module agentos/core/validation/schema-primitives
+ */
+import { z } from 'zod';
+// ── Memory type enums ────────────────────────────────────────────────────
+/**
+ * Tulving's LTM taxonomy extended with relational memory.
+ * - episodic: autobiographical events and experiences
+ * - semantic: general knowledge and facts
+ * - procedural: how-to knowledge and behavioral patterns
+ * - prospective: future intentions and triggered reminders
+ * - relational: trust signals, boundary events, emotional bonds
+ */
+export const MemoryTypeEnum = z.enum([
+    'episodic',
+    'semantic',
+    'procedural',
+    'prospective',
+    'relational',
+]);
+/**
+ * Memory visibility/ownership scope.
+ * - user: about the user (persists across conversations)
+ * - thread: conversation-specific (ephemeral)
+ * - persona: about the agent itself
+ * - organization: shared across agents
+ */
+export const MemoryScopeEnum = z.enum([
+    'user',
+    'thread',
+    'persona',
+    'organization',
+]);
+// ── Common field validators ──────────────────────────────────────────────
+/** Confidence or strength score, clamped to [0, 1]. */
+export const ConfidenceScore = z.number().min(0).max(1);
+/** Array of entity name strings, defaults to empty. */
+export const EntityArray = z.array(z.string()).default([]);
+/** Array of tag strings, defaults to empty. */
+export const TagArray = z.array(z.string()).default([]);
+/** Importance score, clamped to [0, 1], defaults to 0.5. */
+export const ImportanceScore = z.number().min(0).max(1).default(0.5);
+// ── Composite schemas for AgentOS memory pipeline ────────────────────────
+/**
+ * Schema for a single observation note extracted by MemoryObserver.
+ * The Observer LLM produces these as JSONL (one per line).
+ */
+export const ObservationNoteOutput = z.object({
+    /** Observation category. */
+    type: z.enum(['factual', 'emotional', 'commitment', 'preference', 'creative', 'correction']),
+    /** Brief summary of the observation (1-2 sentences max). */
+    content: z.string().min(1),
+    /** How important this observation is for future recall (0-1). */
+    importance: ImportanceScore,
+    /** Key entities mentioned in the observation. */
+    entities: EntityArray,
+});
+/**
+ * Schema for a single reflection trace produced by MemoryReflector.
+ * The Reflector consolidates observation notes into typed long-term traces.
+ */
+export const ReflectionTraceOutput = z.object({
+    /** Chain-of-thought reasoning for why this trace matters (devtools only). */
+    reasoning: z.string().optional(),
+    /** Memory type classification (Tulving's taxonomy + relational). */
+    type: MemoryTypeEnum,
+    /** Memory scope for access control. */
+    scope: MemoryScopeEnum,
+    /** Scope identifier (e.g., user ID, thread ID). */
+    scopeId: z.string().default(''),
+    /** Consolidated memory content. */
+    content: z.string().min(1),
+    /** Entities referenced in this memory. */
+    entities: EntityArray,
+    /** Descriptive tags for retrieval filtering. */
+    tags: TagArray,
+    /** Confidence in this memory's accuracy (0-1). */
+    confidence: ConfidenceScore,
+    /** How this trace was produced. */
+    sourceType: z.enum(['observation', 'reflection']).default('reflection'),
+    /** IDs of existing traces that this trace supersedes (conflict resolution). */
+    supersedes: z.array(z.string()).default([]),
+    /** IDs of observation notes consumed to produce this trace. */
+    consumedNotes: z.array(z.string()).default([]),
+});
+/**
+ * Schema for a compressed observation from ObservationCompressor.
+ * Compresses N raw notes into a dense summary.
+ */
+export const CompressedObservationOutput = z.object({
+    /** Dense summary of multiple observation notes. */
+    summary: z.string().min(1),
+    /** Aggregate importance of the compressed observations. */
+    importance: ImportanceScore,
+    /** Entities across all compressed notes. */
+    entities: EntityArray,
+    /** IDs of the raw notes that were compressed. */
+    noteIds: z.array(z.string()).default([]),
+});
+/**
+ * Schema for content feature detection (LLM strategy).
+ * Used by ContentFeatureDetector when `featureDetectionStrategy === 'llm'`.
+ */
+export const ContentFeaturesOutput = z.object({
+    /** Content contains novel or surprising information. */
+    hasNovelty: z.boolean().default(false),
+    /** Content contains procedural/how-to knowledge. */
+    hasProcedure: z.boolean().default(false),
+    /** Content has emotional charge or sentiment. */
+    hasEmotion: z.boolean().default(false),
+    /** Content involves social interactions or relationships. */
+    hasSocialContent: z.boolean().default(false),
+    /** Content involves cooperative or collaborative themes. */
+    hasCooperation: z.boolean().default(false),
+    /** Content involves ethical or moral considerations. */
+    hasEthicalContent: z.boolean().default(false),
+    /** Content contradicts previously known information. */
+    hasContradiction: z.boolean().default(false),
+    /** Relevance to current task or conversation (0-1). */
+    topicRelevance: z.number().min(0).max(1).default(0.5),
+});
+//# sourceMappingURL=schema-primitives.js.map

package/dist/safety/validation/schema-primitives.js.map

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