@auxiora/personality 1.0.0 → 1.3.0

package/lib/the-architect/emotional-tracker.js

@@ -0,0 +1,210 @@
+// ────────────────────────────────────────────────────────────────────────────
+// Constants
+// ────────────────────────────────────────────────────────────────────────────
+/** How many recent messages the sliding window considers. */
+const WINDOW_SIZE = 5;
+/** Emotions considered negative for escalation detection. */
+const NEGATIVE_EMOTIONS = new Set(['frustrated', 'stressed']);
+/** Minimum consecutive negative-and-increasing entries for escalation. */
+const ESCALATION_MIN_STREAK = 3;
+/** Minimum messages and intensity threshold for escalation alert. */
+const ALERT_MIN_MESSAGES = 4;
+const ALERT_INTENSITY_THRESHOLD = 0.7;
+/** Minimum emotion changes in the window for volatile classification. */
+const VOLATILE_CHANGE_THRESHOLD = 3;
+// ────────────────────────────────────────────────────────────────────────────
+// Intensity estimation
+// ────────────────────────────────────────────────────────────────────────────
+/**
+ * Estimate emotional intensity from message text.
+ *
+ * Heuristic signals:
+ * - Excessive punctuation (!! or ??)
+ * - ALL CAPS segments
+ * - Explicit intensity words ("extremely", "so", "really", "very")
+ * - Profanity / frustration markers
+ * - Message length (longer rants → higher intensity)
+ */
+export function estimateIntensity(message, emotion) {
+    if (emotion === 'neutral')
+        return 0.2;
+    let intensity = 0.4; // base for any non-neutral emotion
+    const lower = message.toLowerCase();
+    // Punctuation intensity
+    const exclamations = (message.match(/!/g) ?? []).length;
+    const questions = (message.match(/\?/g) ?? []).length;
+    if (exclamations >= 3)
+        intensity += 0.15;
+    else if (exclamations >= 1)
+        intensity += 0.05;
+    if (questions >= 3)
+        intensity += 0.1;
+    // CAPS intensity
+    const capsRatio = message.replace(/[^A-Z]/g, '').length / Math.max(message.replace(/\s/g, '').length, 1);
+    if (capsRatio > 0.5 && message.length > 10)
+        intensity += 0.15;
+    // Intensity words
+    const intensifiers = ['extremely', 'incredibly', 'absolutely', 'totally', 'completely', 'so frustrated', 'so tired', 'really', 'very', 'cannot believe', "can't stand"];
+    for (const word of intensifiers) {
+        if (lower.includes(word)) {
+            intensity += 0.08;
+            break; // only count once
+        }
+    }
+    // Frustration markers
+    const frustrationMarkers = ['ugh', 'argh', 'ffs', 'wtf', 'omg', 'seriously', 'again', 'still broken', 'still not working'];
+    for (const marker of frustrationMarkers) {
+        if (lower.includes(marker)) {
+            intensity += 0.08;
+            break;
+        }
+    }
+    // Length-based (longer messages in negative emotions → venting → higher intensity)
+    if (NEGATIVE_EMOTIONS.has(emotion)) {
+        const wordCount = message.split(/\s+/).length;
+        if (wordCount > 50)
+            intensity += 0.1;
+        else if (wordCount > 25)
+            intensity += 0.05;
+    }
+    return Math.min(intensity, 1.0);
+}
+// ────────────────────────────────────────────────────────────────────────────
+// EmotionalTracker
+// ────────────────────────────────────────────────────────────────────────────
+/**
+ * Tracks emotional state across multiple messages, detecting escalation
+ * patterns that a single-message detector would miss.
+ *
+ * If a user is getting progressively more frustrated over 4-5 messages,
+ * the engine should amplify empathy before they reach a breaking point.
+ */
+export class EmotionalTracker {
+    history = [];
+    // ── Recording ───────────────────────────────────────────────────────────
+    /** Record a detected emotion with its intensity and source message. */
+    recordEmotion(emotion, intensity, message) {
+        this.history.push({
+            emotion,
+            intensity: Math.min(Math.max(intensity, 0), 1),
+            timestamp: Date.now(),
+            message,
+        });
+    }
+    // ── Effective emotion ──────────────────────────────────────────────────
+    /**
+     * Get the effective emotional state considering trajectory across the
+     * conversation window.
+     */
+    getEffectiveEmotion() {
+        if (this.history.length === 0) {
+            return { emotion: 'neutral', intensity: 0, trajectory: 'stable', escalationAlert: false };
+        }
+        const latest = this.history[this.history.length - 1];
+        if (this.history.length < 2) {
+            return { emotion: latest.emotion, intensity: latest.intensity, trajectory: 'stable', escalationAlert: false };
+        }
+        // Sliding window: last WINDOW_SIZE entries
+        const window = this.history.slice(-WINDOW_SIZE);
+        // Predominant emotion (mode)
+        const emotionCounts = new Map();
+        let totalIntensity = 0;
+        for (const entry of window) {
+            emotionCounts.set(entry.emotion, (emotionCounts.get(entry.emotion) ?? 0) + 1);
+            totalIntensity += entry.intensity;
+        }
+        const averageIntensity = totalIntensity / window.length;
+        let predominant = 'neutral';
+        let maxCount = 0;
+        for (const [emotion, count] of emotionCounts) {
+            if (count > maxCount) {
+                maxCount = count;
+                predominant = emotion;
+            }
+        }
+        // Detect trajectory
+        const trajectory = this.detectTrajectory(window);
+        // Escalation alert
+        const escalationAlert = trajectory === 'escalating' &&
+            averageIntensity > ALERT_INTENSITY_THRESHOLD &&
+            window.length >= ALERT_MIN_MESSAGES;
+        return {
+            emotion: predominant,
+            intensity: averageIntensity,
+            trajectory,
+            escalationAlert,
+        };
+    }
+    // ── Trajectory detection ───────────────────────────────────────────────
+    detectTrajectory(window) {
+        // Count distinct emotion changes
+        let emotionChanges = 0;
+        for (let i = 1; i < window.length; i++) {
+            if (window[i].emotion !== window[i - 1].emotion) {
+                emotionChanges++;
+            }
+        }
+        // VOLATILE: 3+ emotion changes in window
+        if (emotionChanges >= VOLATILE_CHANGE_THRESHOLD) {
+            return 'volatile';
+        }
+        // ESCALATING: last 3+ messages show increasing intensity of negative emotions
+        if (window.length >= ESCALATION_MIN_STREAK) {
+            const tail = window.slice(-ESCALATION_MIN_STREAK);
+            const allNegative = tail.every(e => NEGATIVE_EMOTIONS.has(e.emotion));
+            if (allNegative) {
+                let increasing = true;
+                for (let i = 1; i < tail.length; i++) {
+                    if (tail[i].intensity < tail[i - 1].intensity) {
+                        increasing = false;
+                        break;
+                    }
+                }
+                if (increasing)
+                    return 'escalating';
+            }
+        }
+        // DE_ESCALATING: was negative, trending toward neutral/positive
+        if (window.length >= 2) {
+            const earlier = window.slice(0, Math.ceil(window.length / 2));
+            const later = window.slice(Math.ceil(window.length / 2));
+            const earlierNegativeRatio = earlier.filter(e => NEGATIVE_EMOTIONS.has(e.emotion)).length / earlier.length;
+            const laterNegativeRatio = later.filter(e => NEGATIVE_EMOTIONS.has(e.emotion)).length / later.length;
+            if (earlierNegativeRatio > 0.5 && laterNegativeRatio < earlierNegativeRatio) {
+                return 'de_escalating';
+            }
+        }
+        // SHIFTING: one distinct change (not same emotion throughout, not volatile)
+        if (emotionChanges >= 1 && emotionChanges < VOLATILE_CHANGE_THRESHOLD) {
+            // Only call it shifting if the latest emotion differs from the earlier predominant
+            const earlierEmotions = window.slice(0, -1);
+            const earlierMode = this.mode(earlierEmotions.map(e => e.emotion));
+            if (window[window.length - 1].emotion !== earlierMode) {
+                return 'shifting';
+            }
+        }
+        // STABLE: same emotion for 3+ messages or no significant change
+        return 'stable';
+    }
+    mode(values) {
+        const counts = new Map();
+        for (const v of values) {
+            counts.set(v, (counts.get(v) ?? 0) + 1);
+        }
+        let best = 'neutral';
+        let bestCount = 0;
+        for (const [val, count] of counts) {
+            if (count > bestCount) {
+                bestCount = count;
+                best = val;
+            }
+        }
+        return best;
+    }
+    // ── Lifecycle ──────────────────────────────────────────────────────────
+    /** Reset for a new conversation — clears all history. */
+    reset() {
+        this.history = [];
+    }
+}
+//# sourceMappingURL=emotional-tracker.js.map

package/lib/the-architect/index.d.ts

@@ -0,0 +1,161 @@
+import type { TraitMix, TaskContext, TraitSource, ContextDomain, PromptOutput } from '../schema.js';
+import { CorrectionStore } from './correction-store.js';
+import type { ArchitectPreferences } from './persistence.js';
+import type { EncryptedStorage } from './persistence-adapter.js';
+import type { WeightPreset } from './custom-weights.js';
+import type { ChatMessage, ExportedConversation } from './conversation-export.js';
+export type { TraitMix, TraitValue, TaskContext, TraitSource, ContextDomain, EmotionalRegister, ContextSignal, PromptOutput, } from '../schema.js';
+export { ARCHITECT_BASE_PROMPT } from './system-prompt.js';
+export { CONTEXT_PROFILES } from './context-profiles.js';
+export { EMOTIONAL_OVERRIDES, applyEmotionalOverride } from './emotional-overrides.js';
+export { detectContext, scoreAllDomains } from './context-detector.js';
+export { assemblePromptModifier, getActiveSources } from './prompt-assembler.js';
+export { SOURCE_MAP } from './source-map.js';
+export { TRAIT_TO_INSTRUCTION } from './trait-to-instruction.js';
+export { CorrectionStore } from './correction-store.js';
+export type { DetectionCorrection, CorrectionPattern } from './correction-store.js';
+export { ContextRecommender } from './recommender.js';
+export type { ContextRecommendation } from './recommender.js';
+export { ConversationContext } from './conversation-context.js';
+export type { ConversationSummary, ConversationState, DetectionRecord } from './conversation-context.js';
+export { EmotionalTracker, estimateIntensity } from './emotional-tracker.js';
+export type { EmotionalTrajectory, EffectiveEmotion } from './emotional-tracker.js';
+export { CustomWeights, WEIGHT_PRESETS } from './custom-weights.js';
+export type { WeightPreset } from './custom-weights.js';
+export { ConversationExporter } from './conversation-export.js';
+export type { ChatMessage, AssistantMetadata, ExportedMessage, ExportedConversation } from './conversation-export.js';
+export { ArchitectPersistence } from './persistence.js';
+export type { ArchitectPreferences } from './persistence.js';
+export type { EncryptedStorage } from './persistence-adapter.js';
+export { InMemoryEncryptedStorage, VaultStorageAdapter } from './persistence-adapter.js';
+export type { VaultLike } from './persistence-adapter.js';
+type Message = {
+    role: string;
+    content: string;
+};
+/**
+ * The Architect personality engine.
+ *
+ * Takes a user message and optional conversation history, detects the
+ * operational context, selects and modulates traits, and assembles a
+ * complete prompt with full provenance for every active trait.
+ *
+ * When constructed with an EncryptedStorage instance, persistence is enabled:
+ * corrections, usage history, and preferences are stored encrypted at rest.
+ * Call `initialize()` once after construction to load persisted state.
+ */
+export declare class TheArchitect {
+    private contextOverride;
+    private correctionStore;
+    private recommender;
+    private conversationContext;
+    private emotionalTracker;
+    private customWeights;
+    private persistence?;
+    private preferences?;
+    private initialized;
+    constructor(storage?: EncryptedStorage);
+    /**
+     * Load persisted state (corrections, preferences, usage history).
+     * Call once after construction. Safe to call multiple times (idempotent).
+     * No-op when persistence is not configured.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Primary method: user message in, complete prompt out.
+     *
+     * Detects context, selects the domain profile, applies emotional
+     * overrides, assembles a weight-scaled prompt modifier, and returns
+     * the full prompt with active trait sources for transparency.
+     *
+     * Also records usage asynchronously (fire-and-forget) and checks
+     * the recommender for context suggestions.
+     */
+    generatePrompt(userMessage: string, history?: Message[]): PromptOutput;
+    /**
+     * Detects the full task context from a user message and optional
+     * conversation history. Exposed publicly for debugging and testing.
+     */
+    detectContext(userMessage: string, history?: Message[]): TaskContext;
+    /**
+     * Returns the fully modulated trait mix for a given context.
+     * Applies the domain's base profile and then emotional overrides.
+     */
+    getTraitMix(context: TaskContext): TraitMix;
+    /** Returns the static base personality prompt. */
+    getBasePrompt(): string;
+    /**
+     * Forces a specific domain regardless of context detection.
+     * Pass `null` to return to automatic detection.
+     */
+    setContextOverride(domain: ContextDomain | null): void;
+    /**
+     * Returns all 17 context domains with human-readable labels
+     * and one-line descriptions for UI rendering.
+     */
+    listContextDomains(): Array<{
+        domain: ContextDomain;
+        label: string;
+        description: string;
+    }>;
+    /**
+     * Returns the active trait sources for the given mix, or for
+     * the general profile if no mix is provided.
+     */
+    getActiveSources(mix?: TraitMix): TraitSource[];
+    /** Reset conversation context and emotional tracker for a new conversation. */
+    resetConversation(): void;
+    /** Get the conversation context summary. */
+    getConversationSummary(): import("./conversation-context.js").ConversationSummary;
+    /** Get the current emotional trajectory. */
+    getEmotionalState(): import("./emotional-tracker.js").EffectiveEmotion;
+    /** Set a custom trait weight offset. Persists if storage is available. */
+    setTraitOverride(trait: keyof TraitMix, offset: number): Promise<void>;
+    /** Remove a custom trait weight override. */
+    removeTraitOverride(trait: keyof TraitMix): Promise<void>;
+    /** Load a preset weight configuration. */
+    loadPreset(presetName: string): Promise<void>;
+    /** Returns available weight presets. */
+    listPresets(): Record<string, WeightPreset>;
+    /** Returns current custom weight overrides. */
+    getActiveOverrides(): Partial<Record<keyof TraitMix, number>>;
+    /** Persist custom weights to encrypted storage. */
+    private persistCustomWeights;
+    /**
+     * Apply trajectory-based multipliers on top of standard emotional overrides.
+     * Caps all values at 1.0.
+     */
+    private applyTrajectoryMultipliers;
+    /**
+     * Records a user correction so the engine can learn from misclassifications.
+     * Also persists the updated corrections to encrypted storage when available.
+     */
+    recordCorrection(userMessage: string, detectedDomain: ContextDomain, correctedDomain: ContextDomain): Promise<void>;
+    /** Load corrections from serialized data (e.g. from encrypted vault). */
+    loadCorrections(serializedData: string): void;
+    /** Export corrections as a serialized string for encrypted storage. */
+    exportCorrections(): string;
+    /** Get correction statistics for debugging and transparency. */
+    getCorrectionStats(): ReturnType<CorrectionStore['getStats']>;
+    /** Returns the current preferences. Falls back to in-memory defaults. */
+    getPreferences(): Promise<ArchitectPreferences>;
+    /** Update a single preference and persist. */
+    updatePreference<K extends keyof ArchitectPreferences>(key: K, value: ArchitectPreferences[K]): Promise<void>;
+    /** Clear all persisted data: corrections, preferences, usage history. */
+    clearAllData(): Promise<void>;
+    /**
+     * Export a conversation with full personality engine metadata.
+     * Returns an ExportedConversation that can be serialized to JSON, Markdown, or CSV.
+     */
+    exportConversation(messages: ChatMessage[], conversationId: string): ExportedConversation;
+    /**
+     * Export a conversation in the specified format.
+     * @param format - 'json' | 'markdown' | 'csv'
+     */
+    exportConversationAs(messages: ChatMessage[], conversationId: string, format: 'json' | 'markdown' | 'csv'): string;
+    /** Export all stored data as JSON string (data portability). */
+    exportData(): Promise<string>;
+}
+/** Creates a new Architect instance, optionally with encrypted persistence. */
+export declare function createArchitect(storage?: EncryptedStorage): TheArchitect;
+//# sourceMappingURL=index.d.ts.map

package/lib/the-architect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMpG,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,YAAY,EACV,QAAQ,EACR,UAAU,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAMpF,KAAK,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AA8BjD;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,eAAe,CAA0C;IAEjE;;;;;;OAMG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,YAAY;IAoBtE;;;OAGG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,WAAW;IAIpE;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ;IAK3C,kDAAkD;IAClD,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAItD;;;OAGG;IACH,kBAAkB,IAAI,KAAK,CAAC;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAI1F;;;OAGG;IACH,gBAAgB,CAAC,GAAG,CAAC,EAAE,QAAQ,GAAG,WAAW,EAAE;IAO/C;;;OAGG;IACH,gBAAgB,CACd,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,aAAa,EAC7B,eAAe,EAAE,aAAa,GAC7B,IAAI;IAWP,yEAAyE;IACzE,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAI7C,uEAAuE;IACvE,iBAAiB,IAAI,MAAM;IAI3B,gEAAgE;IAChE,kBAAkB,IAAI,UAAU,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;CAG9D;AAMD,wCAAwC;AACxC,wBAAgB,eAAe,IAAI,YAAY,CAE9C"}