@framers/agentos 0.1.0

package/dist/cognitive_substrate/persona_overlays/PersonaOverlayManager.js

@@ -0,0 +1,138 @@
+/**
+ * Applies evolution rules to personas and produces runtime overlays that can be persisted
+ * alongside workflow instances.
+ */
+export class PersonaOverlayManager {
+    /**
+     * Evaluates the supplied rules against the context and returns an updated overlay.
+     * @param args - Persona, rules, context, and existing overlay information.
+     * @returns Overlay capturing the persona patches that should be applied.
+     */
+    applyRules(args) {
+        const appliedRules = [];
+        const patches = { ...(args.previousOverlay?.patchedDefinition ?? {}) };
+        for (const rule of args.rules) {
+            if (this.shouldApplyRule(rule, args.context)) {
+                appliedRules.push(rule.id);
+                if (rule.patch?.personaTraits) {
+                    patches.personalityTraits = {
+                        ...(args.persona.personalityTraits ?? {}),
+                        ...rule.patch.personaTraits,
+                    };
+                }
+                if (rule.patch?.mood) {
+                    const currentMood = patches.moodAdaptation ?? args.persona.moodAdaptation ?? {
+                        enabled: true,
+                        defaultMood: rule.patch.mood,
+                    };
+                    patches.moodAdaptation = {
+                        ...currentMood,
+                        enabled: currentMood.enabled ?? true,
+                        defaultMood: rule.patch.mood,
+                    };
+                }
+                if (rule.patch?.metadata) {
+                    patches.customFields = {
+                        ...(args.persona.customFields ?? {}),
+                        ...rule.patch.metadata,
+                    };
+                }
+            }
+        }
+        return {
+            personaId: args.persona.id,
+            appliedRules: [...new Set([...(args.previousOverlay?.appliedRules ?? []), ...appliedRules])],
+            patchedDefinition: patches,
+            metadata: {
+                ...args.previousOverlay?.metadata,
+                previouslyActivated: true,
+                lastEvaluatedAt: new Date().toISOString(),
+                lastContextMetadata: args.context.metadata,
+            },
+        };
+    }
+    /**
+     * Merges the base persona definition with an overlay to produce the effective persona.
+     * @param persona - Base persona definition.
+     * @param overlay - Overlay generated from applied rules.
+     * @returns Persona definition with applied patches.
+     */
+    resolvePersona(persona, overlay) {
+        if (!overlay) {
+            return persona;
+        }
+        return {
+            ...persona,
+            ...overlay.patchedDefinition,
+            personalityTraits: {
+                ...(persona.personalityTraits ?? {}),
+                ...(overlay.patchedDefinition.personalityTraits ?? {}),
+            },
+            customFields: {
+                ...(persona.customFields ?? {}),
+                ...(overlay.patchedDefinition.customFields ?? {}),
+            },
+        };
+    }
+    /**
+     * Determines whether a given rule should be applied. Placeholder implementation that
+     * always returns false until a trigger DSL is defined.
+     * @param rule - Evolution rule under consideration.
+     * @param context - Signals captured during workflow execution.
+     * @returns `true` when the rule should be applied.
+     */
+    shouldApplyRule(rule, context) {
+        if (!rule?.trigger) {
+            return false;
+        }
+        if (typeof rule.trigger === 'string') {
+            return this.matchesStringTrigger(rule.trigger, context);
+        }
+        return Object.entries(rule.trigger).every(([key, expected]) => {
+            const actual = this.readContextValue(context, key);
+            return actual === expected;
+        });
+    }
+    matchesStringTrigger(trigger, context) {
+        const normalized = trigger.toLowerCase();
+        switch (normalized) {
+            case 'always':
+                return true;
+            case 'first_activation':
+                return !context.metadata?.previouslyActivated;
+            case 'task_completed':
+                return context.metadata?.lastEvent === 'task_completed';
+            case 'on_error':
+            case 'error':
+                return (context.metadata?.lastEvent === 'error' ||
+                    context.reasoningSignals?.lastEvent === 'error' ||
+                    context.metadata?.state === 'failed');
+            default:
+                return (context.metadata?.lastEvent === normalized ||
+                    context.metadata?.state === normalized ||
+                    context.roleId === normalized);
+        }
+    }
+    readContextValue(context, key) {
+        if (key.includes('.')) {
+            const [root, ...rest] = key.split('.');
+            const initial = root === 'metadata'
+                ? context.metadata
+                : root === 'signals'
+                    ? context.reasoningSignals
+                    : context[root];
+            return rest.reduce((value, segment) => (value ? value[segment] : undefined), initial);
+        }
+        if (context.metadata && key in context.metadata) {
+            return context.metadata[key];
+        }
+        if (context.reasoningSignals && key in context.reasoningSignals) {
+            return context.reasoningSignals[key];
+        }
+        if (key in context) {
+            return context[key];
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=PersonaOverlayManager.js.map

package/dist/cognitive_substrate/persona_overlays/PersonaOverlayManager.js.map

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

package/dist/cognitive_substrate/persona_overlays/PersonaOverlayTypes.d.ts

@@ -0,0 +1,32 @@
+import type { IPersonaDefinition } from '../personas/IPersonaDefinition';
+import type { PersonaEvolutionRule } from '../../core/workflows/WorkflowTypes';
+/**
+ * Captures the overlay state applied to a persona at runtime.
+ */
+export interface PersonaStateOverlay {
+    personaId: string;
+    appliedRules: string[];
+    patchedDefinition: Partial<IPersonaDefinition>;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Context supplied when evaluating persona evolution rules.
+ */
+export interface PersonaEvolutionContext {
+    workflowId: string;
+    agencyId?: string;
+    roleId: string;
+    recentOutputs?: Array<{
+        taskId: string;
+        output: unknown;
+    }>;
+    reasoningSignals?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface ApplyPersonaRulesArgs {
+    persona: IPersonaDefinition;
+    rules: PersonaEvolutionRule[];
+    context: PersonaEvolutionContext;
+    previousOverlay?: PersonaStateOverlay;
+}
+//# sourceMappingURL=PersonaOverlayTypes.d.ts.map

package/dist/cognitive_substrate/persona_overlays/PersonaOverlayTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersonaOverlayTypes.d.ts","sourceRoot":"","sources":["../../../src/cognitive_substrate/persona_overlays/PersonaOverlayTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,OAAO,EAAE,uBAAuB,CAAC;IACjC,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACvC"}

package/dist/cognitive_substrate/persona_overlays/PersonaOverlayTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=PersonaOverlayTypes.js.map

package/dist/cognitive_substrate/persona_overlays/PersonaOverlayTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersonaOverlayTypes.js","sourceRoot":"","sources":["../../../src/cognitive_substrate/persona_overlays/PersonaOverlayTypes.ts"],"names":[],"mappings":""}

package/dist/cognitive_substrate/personas/IPersonaDefinition.d.ts

@@ -0,0 +1,336 @@
+/**
+ * @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;
+    };
+}
+/**
+ * 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;
+    /** 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[];
+    /** 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/cognitive_substrate/personas/IPersonaDefinition.d.ts.map

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

package/dist/cognitive_substrate/personas/IPersonaDefinition.js

@@ -0,0 +1,8 @@
+// File: backend/agentos/cognitive_substrate/personas/IPersonaDefinition.ts
+/**
+ * @fileoverview This file defines the comprehensive structures and interfaces for Persona Definitions
+ * within AgentOS.
+ * @module backend/agentos/cognitive_substrate/personas/IPersonaDefinition
+ */
+export {};
+//# sourceMappingURL=IPersonaDefinition.js.map

package/dist/cognitive_substrate/personas/IPersonaDefinition.js.map

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

package/dist/cognitive_substrate/personas/IPersonaLoader.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @fileoverview Defines the IPersonaLoader interface, responsible for loading
+ * persona definitions from a specified source. This abstraction allows for
+ * different loading strategies, such as from a file system, a database,
+ * or a remote configuration service.
+ * @module backend/agentos/cognitive_substrate/personas/IPersonaLoader
+ */
+import { IPersonaDefinition } from './IPersonaDefinition';
+/**
+ * Configuration for the PersonaLoader.
+ * @interface PersonaLoaderConfig
+ */
+export interface PersonaLoaderConfig {
+    /**
+     * The source from which to load persona definitions.
+     * This could be a file system path, a database connection string, an API endpoint, etc.
+     * The interpretation of this field is up to the implementing class.
+     * @example "./personas" (for file system loading)
+     * @example "mongodb://localhost:27017/personas" (for database loading)
+     * @type {string}
+     */
+    personaSource: string;
+    /**
+     * Optional: Specifies the type of loader to use, if multiple strategies are supported
+     * by a factory or a more complex loader implementation.
+     * @type {string}
+     * @optional
+     * @example "file_system", "database", "http_endpoint"
+     */
+    loaderType?: string;
+    /**
+     * Optional: Additional configuration parameters specific to the loader type.
+     * @type {Record<string, any>}
+     * @optional
+     */
+    options?: Record<string, any>;
+}
+/**
+ * Defines the contract for a service that loads persona definitions.
+ * Implementations are responsible for retrieving persona configuration data
+ * and transforming it into valid IPersonaDefinition objects.
+ * @interface IPersonaLoader
+ */
+export interface IPersonaLoader {
+    /**
+     * Initializes the persona loader with the given configuration.
+     * @async
+     * @param {PersonaLoaderConfig} config - The configuration for loading personas.
+     * @returns {Promise<void>} A promise that resolves when the loader is initialized.
+     * @throws {Error} If initialization fails (e.g., invalid configuration, source not accessible).
+     */
+    initialize(config: PersonaLoaderConfig): Promise<void>;
+    /**
+     * Loads a single persona definition by its unique ID.
+     * @async
+     * @param {string} personaId - The ID of the persona to load.
+     * @returns {Promise<IPersonaDefinition | undefined>} A promise that resolves with the persona definition
+     * if found, or undefined otherwise.
+     * @throws {Error} If loading fails for reasons other than the persona not being found (e.g., parsing error, source error).
+     */
+    loadPersonaById(personaId: string): Promise<IPersonaDefinition | undefined>;
+    /**
+     * Loads all available persona definitions from the configured source.
+     * @async
+     * @returns {Promise<IPersonaDefinition[]>} A promise that resolves with an array of all loaded
+     * persona definitions. Returns an empty array if no personas are found.
+     * @throws {Error} If loading fails (e.g., source inaccessible, multiple parsing errors).
+     */
+    loadAllPersonaDefinitions(): Promise<IPersonaDefinition[]>;
+    /**
+     * Optional: Reloads persona definitions. Useful if personas can change dynamically.
+     * @async
+     * @returns {Promise<void>} A promise that resolves when personas have been reloaded.
+     * @throws {Error} If reloading fails.
+     */
+    refreshPersonas?(): Promise<void>;
+}
+//# sourceMappingURL=IPersonaLoader.d.ts.map

package/dist/cognitive_substrate/personas/IPersonaLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPersonaLoader.d.ts","sourceRoot":"","sources":["../../../src/cognitive_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/cognitive_substrate/personas/IPersonaLoader.js

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Defines the IPersonaLoader interface, responsible for loading
+ * persona definitions from a specified source. This abstraction allows for
+ * different loading strategies, such as from a file system, a database,
+ * or a remote configuration service.
+ * @module backend/agentos/cognitive_substrate/personas/IPersonaLoader
+ */
+export {};
+//# sourceMappingURL=IPersonaLoader.js.map

package/dist/cognitive_substrate/personas/IPersonaLoader.js.map

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