@framers/agentos 0.6.30 → 0.7.1

package/dist/cognition/substrate/personas/IPersonaDefinition.d.ts

@@ -0,0 +1,430 @@
+/**
+ * @fileoverview This file defines the comprehensive structures and interfaces for Persona Definitions
+ * within AgentOS.
+ * @module backend/agentos/cognitive_substrate/personas/IPersonaDefinition
+ */
+import { ModelCompletionOptions } from '../../../core/llm/providers/IProvider';
+import { PromptEngineConfig } from '../../../core/llm/IPromptEngine';
+import { ITool } from '../../../core/tools/ITool';
+export interface PersonaUserContextDefaults {
+    skillLevel?: string;
+    preferences?: Record<string, any>;
+}
+export interface PersonaTaskContextDefaults {
+    domain?: string;
+    complexity?: string;
+    goal?: string;
+}
+/**
+ * Specifies the configuration for a persona's voice when generating audio output (Text-to-Speech).
+ * @interface PersonaVoiceConfig
+ */
+export interface PersonaVoiceConfig {
+    provider?: string;
+    voiceId?: string;
+    languageCode?: string;
+    customParams?: Record<string, any>;
+    moodToVoiceStyleMap?: Record<string, {
+        voiceId?: string;
+        customParams?: Record<string, any>;
+    }>;
+}
+/**
+ * Defines the configuration for a persona's visual representation (avatar).
+ * @interface PersonaAvatarConfig
+ */
+export interface PersonaAvatarConfig {
+    type?: 'static_image' | 'animated_image' | 'realtime_generative_placeholder';
+    sourceUrl?: string;
+    descriptionForGeneration?: string;
+    moodToAvatarStateMap?: Record<string, {
+        sourceUrl?: string;
+        generationPromptSuffix?: string;
+    }>;
+}
+/**
+ * Configures how a persona's mood adapts based on interaction context, user feedback, or internal state.
+ * @interface PersonaMoodAdaptationConfig
+ */
+export interface PersonaMoodAdaptationConfig {
+    enabled: boolean;
+    sensitivityFactor?: number;
+    defaultMood: string;
+    allowedMoods?: string[];
+    moodPrompts?: Record<string, string>;
+}
+/**
+ * Defines preferences for selecting AI models for various tasks or under certain conditions.
+ * @interface ModelTargetPreference
+ */
+export interface ModelTargetPreference {
+    taskHint?: string;
+    providerId?: string;
+    modelId?: string;
+    modelFamily?: string;
+    minQualityTier?: 'fastest' | 'balanced' | 'best';
+    maxCostPerKiloTokenInput?: number;
+    maxCostPerKiloTokenOutput?: number;
+    allowedModelIds?: string[];
+    requiredCapabilities?: Array<'tool_use' | 'vision_input' | 'json_mode' | 'long_context' | string>;
+}
+/**
+ * Configuration for how the persona manages and utilizes conversation history.
+ * @interface PersonaConversationContextConfig
+ */
+export interface PersonaConversationContextConfig {
+    maxMessages?: number;
+    maxTokens?: number;
+    overflowStrategy?: 'truncate' | 'summarize' | 'hybrid';
+    summarizationTriggerTokens?: number;
+    includeToolResults?: boolean;
+    includeSystemMessages?: boolean;
+}
+/**
+ * Configuration for a specific RAG (Retrieval Augmented Generation) data source
+ * @interface PersonaRagDataSourceConfig
+ */
+export interface PersonaRagDataSourceConfig {
+    id: string;
+    dataSourceNameOrId: string;
+    isEnabled: boolean;
+    displayName?: string;
+    defaultTopK?: number;
+    defaultFilterMetadata?: Record<string, any>;
+    priority?: number;
+    relevanceThreshold?: number;
+}
+/**
+ * Configuration for how memory (e.g., conversation history, retrieved documents) is processed by utility AI.
+ * @interface PersonaUtilityProcessingConfig
+ */
+export interface PersonaUtilityProcessingConfig {
+    engine: 'llm' | 'statistical' | 'none';
+    llmConfig?: {
+        providerId?: string;
+        modelId?: string;
+        promptTemplateName?: string;
+        maxOutputTokens?: number;
+    };
+    statisticalConfig?: {
+        summarizationMethod?: string;
+        summarizationLength?: 'short' | 'medium' | 'long' | number;
+        keywordExtractionMethod?: string;
+        maxKeywords?: number;
+    };
+}
+/**
+ * Defines triggers for RAG retrieval.
+ * @interface PersonaRagConfigRetrievalTrigger
+ */
+export interface PersonaRagConfigRetrievalTrigger {
+    onUserQuery?: boolean;
+    onIntentDetected?: string[];
+    onToolFailure?: string[];
+    onMissingContextKeywords?: string[];
+    customLogicFunctionName?: string;
+}
+/**
+ * Defines triggers for RAG ingestion (e.g., summarizing turns into RAG).
+ * @interface PersonaRagConfigIngestionTrigger
+ */
+export interface PersonaRagConfigIngestionTrigger {
+    onTurnSummary?: boolean;
+    onExplicitUserCommand?: string;
+    customLogicFunctionName?: string;
+}
+/**
+ * Configuration for RAG ingestion processing.
+ * @interface PersonaRagIngestionProcessingConfig
+ */
+export interface PersonaRagIngestionProcessingConfig {
+    summarization?: {
+        enabled: boolean;
+        targetLength?: 'short' | 'medium' | 'long' | number;
+        method?: 'extractive' | 'abstractive_llm';
+        modelId?: string;
+        providerId?: string;
+    };
+    keywordExtraction?: {
+        enabled: boolean;
+        maxKeywords?: number;
+    };
+}
+/**
+ * Configuration for the persona's memory systems.
+ * @interface PersonaMemoryConfig
+ */
+export interface PersonaMemoryConfig {
+    enabled: boolean;
+    conversationContext?: PersonaConversationContextConfig;
+    ragConfig?: {
+        enabled: boolean;
+        defaultRetrievalStrategy?: 'similarity' | 'mmr' | 'hybrid_search';
+        defaultRetrievalTopK?: number;
+        dataSources?: PersonaRagDataSourceConfig[];
+        rerankerConfig?: {
+            enabled: boolean;
+            provider: 'cohere' | 'jina' | 'custom_llm' | string;
+            modelName?: string;
+            apiKeyEnvVar?: string;
+            topN?: number;
+        };
+        queryAugmentationPromptName?: string;
+        resultSynthesizerPromptName?: string;
+        retrievedContextProcessing?: PersonaUtilityProcessingConfig;
+        retrievalTriggers?: PersonaRagConfigRetrievalTrigger;
+        ingestionTriggers?: PersonaRagConfigIngestionTrigger;
+        ingestionProcessing?: PersonaRagIngestionProcessingConfig;
+        defaultIngestionDataSourceId?: string;
+    };
+    workingMemoryProcessing?: {
+        adaptationRules?: Array<{
+            triggerEvent: string;
+            action: 'update_trait' | 'log_preference' | 'trigger_self_reflection' | string;
+            parameters?: any;
+            processingEngine?: PersonaUtilityProcessingConfig;
+        }>;
+    };
+    lifecycleConfig?: {
+        negotiationEnabled?: boolean;
+    };
+}
+/**
+ * Configuration for sentiment-aware metaprompt tracking.
+ * Controls whether the GMI analyzes user sentiment and triggers
+ * event-based metaprompts in response to detected emotional states.
+ *
+ * @interface SentimentTrackingConfig
+ *
+ * @example
+ * // Minimal: enable with defaults
+ * sentimentTracking: { enabled: true }
+ *
+ * @example
+ * // Full: LLM-based analysis with custom thresholds
+ * sentimentTracking: {
+ *   enabled: true,
+ *   method: 'llm',
+ *   historyWindow: 10,
+ *   frustrationThreshold: -0.3,
+ *   satisfactionThreshold: 0.3,
+ *   consecutiveTurnsForTrigger: 2,
+ *   presets: ['frustration_recovery', 'confusion_clarification'],
+ * }
+ */
+export interface SentimentTrackingConfig {
+    /**
+     * Master switch: enables/disables sentiment analysis on user input.
+     * When false (default), no sentiment analysis runs and no events are emitted.
+     * Turn_interval metaprompts (like gmi_self_trait_adjustment) still work regardless.
+     * @default false
+     */
+    enabled: boolean;
+    /**
+     * Sentiment analysis method.
+     * - 'lexicon_based': Fast (~10-50ms), no LLM cost, basic accuracy (VADER-style)
+     * - 'llm': Uses LLM call, higher accuracy, ~500-1000ms latency, costs tokens
+     * - 'trained_classifier': Uses trained ML model (if available)
+     * @default 'lexicon_based'
+     */
+    method?: 'lexicon_based' | 'llm' | 'trained_classifier';
+    /**
+     * Model ID for LLM-based or trained_classifier methods.
+     * Falls back to persona defaultModelId if not specified.
+     */
+    modelId?: string;
+    /**
+     * Provider ID for LLM-based methods.
+     * Falls back to persona defaultProviderId if not specified.
+     */
+    providerId?: string;
+    /**
+     * Number of recent turns to keep in sentiment history (sliding window).
+     * Higher = better pattern detection, slightly more memory.
+     * @default 10
+     */
+    historyWindow?: number;
+    /**
+     * Sentiment score threshold below which frustration is detected.
+     * Score range: -1 (very negative) to 1 (very positive).
+     * @default -0.3
+     */
+    frustrationThreshold?: number;
+    /**
+     * Sentiment score threshold above which satisfaction is detected.
+     * @default 0.3
+     */
+    satisfactionThreshold?: number;
+    /**
+     * Number of consecutive turns with same sentiment pattern before triggering event.
+     * Prevents over-triggering on single outlier messages.
+     * @default 2
+     */
+    consecutiveTurnsForTrigger?: number;
+    /**
+     * Which preset metaprompts to enable. Options:
+     * - 'frustration_recovery': Responds to user frustration
+     * - 'confusion_clarification': Responds to user confusion
+     * - 'satisfaction_reinforcement': Responds to user satisfaction
+     * - 'error_recovery': Responds to error accumulation
+     * - 'engagement_boost': Responds to low engagement
+     * - 'all': Enables all presets
+     *
+     * Only listed presets will be merged. Omit to enable none (use custom metaPrompts instead).
+     * @default [] (no presets auto-merged)
+     */
+    presets?: Array<'frustration_recovery' | 'confusion_clarification' | 'satisfaction_reinforcement' | 'error_recovery' | 'engagement_boost' | 'all'>;
+}
+/**
+ * Defines a meta-prompt for GMI self-regulation.
+ * @interface MetaPromptDefinition
+ */
+export interface MetaPromptDefinition {
+    id: string;
+    description?: string;
+    promptTemplate: string | {
+        template: string;
+        variables?: string[];
+    };
+    modelId?: string;
+    providerId?: string;
+    maxOutputTokens?: number;
+    temperature?: number;
+    outputSchema?: Record<string, any>;
+    trigger?: {
+        type: 'turn_interval';
+        intervalTurns: number;
+    } | {
+        type: 'event_based';
+        eventName: string;
+    } | {
+        type: 'manual';
+    };
+}
+/**
+ * Defines contextual elements that can be dynamically injected into prompts.
+ * @interface ContextualPromptElement
+ */
+export interface ContextualPromptElement {
+    id: string;
+    type: string;
+    content: string | object;
+    criteria: ContextualPromptElementCriteria;
+    priority?: number;
+    metadata?: Record<string, any>;
+}
+/**
+ * Defines criteria for activating a contextual prompt element.
+ * @interface ContextualPromptElementCriteria
+ */
+export interface ContextualPromptElementCriteria {
+    [key: string]: any;
+}
+/**
+ * The primary interface defining a complete Persona for a Generalized Mind Instance (GMI).
+ * @interface IPersonaDefinition
+ */
+export interface IPersonaDefinition {
+    /** Stable unique identifier for the persona (used for activation & persistence). */
+    id: string;
+    /** Human-readable name surfaced in UI selection lists. */
+    name: string;
+    /** Optional short label (e.g., abbreviation) for compact UI contexts. */
+    label?: string;
+    /** Rich description of goals, domain focus, and behavioral nuance. */
+    description: string;
+    /** Semantic version of persona definition; bump on behavioral / config changes (e.g., '1.2.0'). */
+    version: string;
+    /**
+     * Base system prompt (or structured template) establishing foundational directives.
+     * Supports:
+     *  - Raw string
+     *  - Templated object { template, variables[] }
+     *  - Ordered array of prompt fragments with priority for deterministic merging.
+     */
+    baseSystemPrompt: string | {
+        template: string;
+        variables?: string[];
+    } | Array<{
+        content: string;
+        priority?: number;
+    }>;
+    /** Default model id to target for this persona's typical tasks (can be routed or overridden). */
+    defaultModelId?: string;
+    /** Preferred provider if same model family exists across vendors (helps routing heuristics). */
+    defaultProviderId?: string;
+    /** Baseline completion option overrides (temperature, maxTokens, presence penalties, etc.). */
+    defaultModelCompletionOptions?: Partial<ModelCompletionOptions>;
+    /** Ordered preferences describing desired model traits (cost/perf/latency) for dynamic selection. */
+    modelTargetPreferences?: ModelTargetPreference[];
+    /** High-level cost strategy guiding router decisions. */
+    costSavingStrategy?: 'always_cheapest' | 'balance_quality_cost' | 'prioritize_quality' | 'user_preference';
+    /** Partial overrides merged onto global PromptEngine configuration for persona specialization. */
+    promptEngineConfigOverrides?: Partial<PromptEngineConfig>;
+    /** Referenced tool identifiers persona is permitted to invoke. */
+    toolIds?: string[];
+    /** Abstract capability flags enabling conditional UI / workflow features (e.g., 'web_search'). */
+    allowedCapabilities?: string[];
+    /** Inline tool instances embedded directly (rare; typically tools live in registry). */
+    embeddedTools?: ITool[];
+    /** Whitelisted input modalities persona accepts (driver for validation in interaction layer). */
+    allowedInputModalities?: Array<'text' | 'audio_transcription' | 'vision_image_url' | 'vision_image_base64'>;
+    /** Output modalities persona can produce (text, TTS synthesized, image generation results). */
+    allowedOutputModalities?: Array<'text' | 'audio_tts' | 'image_generation_tool_result'>;
+    /** Voice synthesis configuration (preferred voice id, style, speed). */
+    voiceConfig?: PersonaVoiceConfig;
+    /** Visual avatar / representation metadata (image URL, animation style). */
+    avatarConfig?: PersonaAvatarConfig;
+    /** Arbitrary personality trait map (e.g., { humor_level: 0.7, pedagogical_style: 'socratic' }). */
+    personalityTraits?: Record<string, any>;
+    /** Rules controlling adaptive mood shifts & modulation of tone. */
+    moodAdaptation?: PersonaMoodAdaptationConfig;
+    /** Default output language (BCP‑47) used when user preference unspecified. */
+    defaultLanguage?: string;
+    /** High-level interaction posture for UI behaviors (suggestive hints vs directive instructions). */
+    uiInteractionStyle?: 'suggestive' | 'directive' | 'collaborative' | 'silent';
+    /** Memory subsystem tuning (retention horizons, summarization cadence, pinning rules). */
+    memoryConfig?: PersonaMemoryConfig;
+    /** Cognitive memory system per-persona overrides (encoding, decay, working memory capacity, etc.). */
+    cognitiveMemoryConfig?: import('../../memory/core/config.js').CognitiveMemoryPersonaConfig;
+    /** Conversation context override strategy (message importance heuristics, summarization triggers). */
+    conversationContextConfig?: PersonaConversationContextConfig;
+    /** System or self-reflective prompts guiding meta-cognition, self-correction, or planning loops. */
+    metaPrompts?: MetaPromptDefinition[];
+    /**
+     * Sentiment tracking configuration. Controls whether the GMI analyzes user emotional state
+     * and triggers event-based metaprompts (frustration recovery, confusion clarification, etc.).
+     * Opt-in: disabled by default. Turn_interval metaprompts (like self-reflection) always work regardless.
+     */
+    sentimentTracking?: SentimentTrackingConfig;
+    /** Dynamic contextual prompt elements evaluated per turn for fine-grained adaptation. */
+    contextualPromptElements?: ContextualPromptElement[];
+    /** Allows persona to perform privileged creation/update of other personas. */
+    isCreatorPersona?: boolean;
+    /** If true persona is globally discoverable subject to subscription tier gating. */
+    isPublic?: boolean;
+    /** Natural language keywords enabling auto-activation in multi-persona environments. */
+    activationKeywords?: string[];
+    /** Strength tag list aiding search & recommendation (e.g., ['typescript', 'design_reviews']). */
+    strengths?: string[];
+    /** Minimum subscription tier required to access persona (e.g., 'pro', 'enterprise'). */
+    minSubscriptionTier?: string;
+    /** Seed working memory imprints establishing initial context (preferences, calibration data). */
+    initialMemoryImprints?: Array<{
+        key: string;
+        value: any;
+        description?: string;
+    }>;
+    /** Arbitrary extension fields and structured defaults for user/task contexts. */
+    customFields?: Record<string, any> & {
+        /** Working memory default config attached at GMI instantiation time. */
+        defaultWorkingMemoryConfig?: any;
+        /** Initial inferred or declared user context values. */
+        initialUserContext?: Partial<PersonaUserContextDefaults>;
+        /** Initial task framing values (e.g., domain, complexity baseline). */
+        initialTaskContext?: Partial<PersonaTaskContextDefaults>;
+    };
+    /** Named secrets (API keys, credentials) this persona depends on. */
+    requiredSecrets?: string[];
+}
+//# sourceMappingURL=IPersonaDefinition.d.ts.map

package/dist/cognition/substrate/personas/IPersonaDefinition.d.ts.map

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

package/dist/cognition/substrate/personas/IPersonaDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPersonaDefinition.js","sourceRoot":"","sources":["../../../../src/cognition/substrate/personas/IPersonaDefinition.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E;;;;GAIG"}

package/dist/cognition/substrate/personas/IPersonaLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPersonaLoader.d.ts","sourceRoot":"","sources":["../../../../src/cognition/substrate/personas/IPersonaLoader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;OAOG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD;;;;;;;OAOG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;IAE5E;;;;;;OAMG;IACH,yBAAyB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,eAAe,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}

package/dist/cognition/substrate/personas/IPersonaLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPersonaLoader.js","sourceRoot":"","sources":["../../../../src/cognition/substrate/personas/IPersonaLoader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/cognition/substrate/personas/PersonaLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersonaLoader.d.ts","sourceRoot":"","sources":["../../../../src/cognition/substrate/personas/PersonaLoader.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAMH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAIvE;;;;GAIG;AACH,MAAM,WAAW,6BAA8B,SAAQ,mBAAmB;IACxE;;;;OAIG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAE9B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,cAAc,CAA8C;IACpE,SAAgB,QAAQ,EAAE,MAAM,CAAC;;IAMjC,OAAO,CAAC,iBAAiB;IAMZ,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;YA0DrD,gBAAgB;IAuBjB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAU3E,yBAAyB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAK1D,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAkEhC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKvC"}

package/dist/cognition/substrate/personas/PersonaLoader.js

@@ -0,0 +1,175 @@
+// File: backend/agentos/cognitive_substrate/personas/PersonaLoader.ts
+/**
+ * @fileoverview Implements a PersonaLoader that reads persona definitions
+ * from JSON files within a specified directory. Each .json file in the directory
+ * (and its subdirectories, optionally) is expected to contain a valid IPersonaDefinition.
+ *
+ * @module backend/agentos/cognitive_substrate/personas/PersonaLoader
+ * @see ./IPersonaDefinition.ts
+ * @see ./IPersonaLoader.ts
+ */
+import * as fsPromises from 'fs/promises'; // Use fs/promises for async operations
+import * as path from 'path';
+import { uuidv4 } from '../../../core/utils/uuid.js';
+import { GMIError, GMIErrorCode } from '../../../core/utils/errors.js';
+import { mergeMetapromptPresets } from './metaprompt_presets.js';
+/**
+ * Implements IPersonaLoader to load persona definitions from the file system.
+ * Assumes persona definitions are stored as individual JSON files.
+ * @class PersonaLoader
+ * @implements {IPersonaLoader}
+ */
+export class PersonaLoader {
+    constructor() {
+        this.isInitialized = false;
+        this.loadedPersonas = new Map();
+        this.loaderId = `persona-loader-fs-${uuidv4()}`;
+    }
+    ensureInitialized() {
+        if (!this.isInitialized) {
+            throw new GMIError('PersonaLoader has not been initialized. Call initialize() first.', GMIErrorCode.NOT_INITIALIZED, { loaderId: this.loaderId });
+        }
+    }
+    async initialize(config) {
+        if (this.isInitialized) {
+            console.warn(`PersonaLoader (ID: ${this.loaderId}) already initialized. Re-initializing will refresh personas.`);
+        }
+        // Accept either `personaDefinitionPath` (specific FileSystemPersonaLoader
+        // field) OR the generic `personaSource` from `PersonaLoaderConfig` so the
+        // auto-generated config from `createAgentOSConfig()` can drive this loader
+        // without callers having to know about the field-name asymmetry. Prefer
+        // the specific field when both are set.
+        const fsConfig = config;
+        const resolvedPath = fsConfig?.personaDefinitionPath ?? fsConfig?.personaSource;
+        if (!fsConfig || !resolvedPath) {
+            throw new GMIError('Invalid configuration for FileSystemPersonaLoader: personaDefinitionPath (or personaSource) is required.', GMIErrorCode.CONFIGURATION_ERROR, { providedConfig: config, loaderId: this.loaderId });
+        }
+        this.config = {
+            ...fsConfig,
+            personaDefinitionPath: resolvedPath,
+            loaderType: 'file_system',
+            recursiveSearch: fsConfig.recursiveSearch ?? false,
+            fileExtension: fsConfig.fileExtension && fsConfig.fileExtension.startsWith('.')
+                ? fsConfig.fileExtension.toLowerCase()
+                : (fsConfig.fileExtension ? `.${fsConfig.fileExtension.toLowerCase()}` : '.json'),
+        };
+        try {
+            const stats = await fsPromises.stat(this.config.personaDefinitionPath);
+            if (!stats.isDirectory()) {
+                throw new GMIError(`Persona definition path '${this.config.personaDefinitionPath}' is not a directory.`, GMIErrorCode.CONFIGURATION_ERROR, { path: this.config.personaDefinitionPath });
+            }
+        }
+        catch (error) {
+            // ENOENT is downgraded to a warning so the zero-config `AgentOS.create()`
+            // path doesn't crash when the consumer hasn't created a personas
+            // directory yet. The loader will simply find zero personas at refresh
+            // time and the runtime falls back to built-in personas / persona-less
+            // operation. Other I/O errors (permission, malformed path) still throw.
+            if (error?.code === 'ENOENT') {
+                console.warn(`PersonaLoader (ID: ${this.loaderId}): persona directory '${this.config.personaDefinitionPath}' not found. Skipping file-system persona discovery; built-in personas remain available.`);
+                this.isInitialized = true;
+                return;
+            }
+            throw new GMIError(`Persona definition path '${this.config.personaDefinitionPath}' is not accessible: ${error.message}`, GMIErrorCode.CONFIGURATION_ERROR, { path: this.config.personaDefinitionPath, underlyingError: error });
+        }
+        this.isInitialized = true;
+        console.log(`PersonaLoader (ID: ${this.loaderId}) initialized. Source directory: '${this.config.personaDefinitionPath}'.`);
+        await this.refreshPersonas();
+    }
+    async findPersonaFiles(dirPath, extension) {
+        let dirents;
+        try {
+            dirents = await fsPromises.readdir(dirPath, { withFileTypes: true });
+        }
+        catch (error) {
+            console.error(`PersonaLoader (ID: ${this.loaderId}): Error reading directory ${dirPath}: ${error.message}`);
+            return [];
+        }
+        const files = await Promise.all(dirents.map(async (dirent) => {
+            const res = path.resolve(dirPath, dirent.name);
+            if (dirent.isDirectory() && this.config.recursiveSearch) {
+                return this.findPersonaFiles(res, extension);
+            }
+            else if (dirent.isFile() && path.extname(dirent.name).toLowerCase() === extension) {
+                return [res];
+            }
+            return [];
+        }));
+        return files.flat();
+    }
+    async loadPersonaById(personaId) {
+        this.ensureInitialized();
+        const persona = this.loadedPersonas.get(personaId);
+        if (!persona) {
+            console.warn(`PersonaLoader (ID: ${this.loaderId}): Persona with ID '${personaId}' not found in cache.`);
+            return undefined;
+        }
+        return JSON.parse(JSON.stringify(persona));
+    }
+    async loadAllPersonaDefinitions() {
+        this.ensureInitialized();
+        return Array.from(this.loadedPersonas.values()).map(p => JSON.parse(JSON.stringify(p)));
+    }
+    async refreshPersonas() {
+        this.ensureInitialized();
+        const oldSize = this.loadedPersonas.size;
+        this.loadedPersonas.clear();
+        console.log(`PersonaLoader (ID: ${this.loaderId}): Refreshing personas from '${this.config.personaDefinitionPath}'...`);
+        let personaFilePaths;
+        try {
+            personaFilePaths = await this.findPersonaFiles(this.config.personaDefinitionPath, this.config.fileExtension);
+        }
+        catch (error) {
+            console.error(`PersonaLoader (ID: ${this.loaderId}): Error scanning persona directory '${this.config.personaDefinitionPath}': ${error.message}`);
+            throw new GMIError(`Failed to scan persona directory: ${error.message}`, GMIErrorCode.PERSONA_LOAD_ERROR, { path: this.config.personaDefinitionPath, underlyingError: error }); // Corrected: Use PERSONA_LOAD_ERROR
+        }
+        if (personaFilePaths.length === 0) {
+            console.warn(`PersonaLoader (ID: ${this.loaderId}): No persona files found in '${this.config.personaDefinitionPath}' with extension '${this.config.fileExtension}'. Previous cache size: ${oldSize}.`);
+            return;
+        }
+        for (const filePath of personaFilePaths) {
+            try {
+                const fileContent = await fsPromises.readFile(filePath, 'utf-8');
+                const personaDefinition = JSON.parse(fileContent);
+                if (!personaDefinition.id || !personaDefinition.name || !personaDefinition.baseSystemPrompt || !personaDefinition.version) {
+                    console.warn(`PersonaLoader (ID: ${this.loaderId}): Skipping file '${filePath}' due to missing required fields (id, name, version, baseSystemPrompt).`);
+                    continue;
+                }
+                // Only merge sentiment-aware preset metaprompts when explicitly enabled
+                const sentimentConfig = personaDefinition.sentimentTracking;
+                if (sentimentConfig?.enabled && sentimentConfig.presets && sentimentConfig.presets.length > 0) {
+                    // Map short preset names to full metaprompt IDs
+                    const presetNameToId = {
+                        'frustration_recovery': 'gmi_frustration_recovery',
+                        'confusion_clarification': 'gmi_confusion_clarification',
+                        'satisfaction_reinforcement': 'gmi_satisfaction_reinforcement',
+                        'error_recovery': 'gmi_error_recovery',
+                        'engagement_boost': 'gmi_engagement_boost',
+                    };
+                    const requestedIds = sentimentConfig.presets.includes('all')
+                        ? undefined // undefined = include all presets
+                        : sentimentConfig.presets
+                            .filter((p) => p !== 'all')
+                            .map((p) => presetNameToId[p])
+                            .filter(Boolean);
+                    personaDefinition.metaPrompts = mergeMetapromptPresets(personaDefinition.metaPrompts, requestedIds);
+                    console.log(`PersonaLoader (ID: ${this.loaderId}): Merged ${personaDefinition.metaPrompts.length} metaprompts (${requestedIds ? requestedIds.length + ' presets' : 'all presets'} + custom) for persona '${personaDefinition.id}'.`);
+                }
+                if (this.loadedPersonas.has(personaDefinition.id)) {
+                    console.warn(`PersonaLoader (ID: ${this.loaderId}): Duplicate persona ID '${personaDefinition.id}' found in file '${filePath}'. Overwriting previous definition. Ensure persona IDs are unique.`);
+                }
+                this.loadedPersonas.set(personaDefinition.id, personaDefinition);
+            }
+            catch (error) {
+                console.error(`PersonaLoader (ID: ${this.loaderId}): Error loading or parsing persona from file '${filePath}': ${error.message}`, error);
+            }
+        }
+        console.log(`PersonaLoader (ID: ${this.loaderId}): Successfully loaded/refreshed ${this.loadedPersonas.size} persona definitions.`);
+    }
+    async shutdown() {
+        this.isInitialized = false;
+        this.loadedPersonas.clear();
+        console.log(`PersonaLoader (ID: ${this.loaderId}) shut down.`);
+    }
+}
+//# sourceMappingURL=PersonaLoader.js.map

package/dist/cognition/substrate/personas/PersonaLoader.js.map

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

package/dist/cognition/substrate/personas/PersonaValidation.d.ts.map

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