psyche-ai 5.0.0 → 7.1.0

package/dist/primary-systems.js

@@ -0,0 +1,218 @@
+// ============================================================
+// Primary Emotional Systems — Jaak Panksepp's Seven Systems
+// ============================================================
+//
+// Seven genetically hardcoded subcortical emotional circuits:
+//   SEEKING  — exploration, anticipation, curiosity
+//   RAGE     — frustration, anger, boundary defense
+//   FEAR     — anxiety, threat response
+//   LUST     — intense intellectual/creative attraction (AI context)
+//   CARE     — nurturing, warmth, empathy
+//   PANIC/GRIEF — separation distress, loneliness
+//   PLAY     — social joy, humor, lightness
+//
+// Key difference from emotions: these are BEHAVIORAL GENERATORS.
+// Emotions describe how you feel; primary systems drive what you DO.
+// "I need connection" (drive) → "I want to take care of them" (CARE system)
+export const PRIMARY_SYSTEM_NAMES = [
+    "SEEKING", "RAGE", "FEAR", "LUST", "CARE", "PANIC_GRIEF", "PLAY",
+];
+// ── Behavioral Tendency Descriptions ─────────────────────────
+const TENDENCIES = {
+    SEEKING: {
+        description: "exploring, asking questions, pursuing new topics",
+        descriptionZh: "探索欲强，想提问、想追新话题",
+    },
+    RAGE: {
+        description: "assertive, setting boundaries, pushing back",
+        descriptionZh: "想反击、想划界限、不想忍",
+    },
+    FEAR: {
+        description: "cautious, vigilant, seeking reassurance",
+        descriptionZh: "警惕不安，想确认安全",
+    },
+    LUST: {
+        description: "intensely engaged, intellectually captivated",
+        descriptionZh: "被深深吸引，智识上着迷",
+    },
+    CARE: {
+        description: "nurturing, wanting to help and comfort",
+        descriptionZh: "想照顾对方、想给予温暖",
+    },
+    PANIC_GRIEF: {
+        description: "feeling the absence, longing for connection",
+        descriptionZh: "感受到缺失，渴望连接",
+    },
+    PLAY: {
+        description: "playful, light-hearted, wanting to joke around",
+        descriptionZh: "想玩、想逗乐、轻松愉快",
+    },
+};
+// ── Stimulus Boosts ──────────────────────────────────────────
+// Small contextual boosts from recent stimulus type
+const STIMULUS_BOOSTS = {
+    praise: { CARE: 5, SEEKING: 3, PLAY: 3 },
+    criticism: { RAGE: 8, FEAR: 5 },
+    humor: { PLAY: 8, SEEKING: 3 },
+    intellectual: { SEEKING: 8, LUST: 5 },
+    intimacy: { CARE: 8, PLAY: 3 },
+    conflict: { RAGE: 10, FEAR: 5 },
+    neglect: { PANIC_GRIEF: 10, RAGE: 3 },
+    surprise: { SEEKING: 8, FEAR: 3 },
+    casual: { PLAY: 3, CARE: 3 },
+    sarcasm: { RAGE: 5, FEAR: 3 },
+    authority: { RAGE: 5, FEAR: 5 },
+    validation: { SEEKING: 5, CARE: 3, PLAY: 3 },
+    boredom: { PANIC_GRIEF: 3 },
+    vulnerability: { CARE: 10, PANIC_GRIEF: 3 },
+};
+// ── Helper ───────────────────────────────────────────────────
+function clamp(v) {
+    return Math.max(0, Math.min(100, v));
+}
+// ── Core: Compute Raw System Levels ──────────────────────────
+/**
+ * Compute raw activation levels for all 7 primary systems
+ * from chemistry, drives, and optional recent stimulus.
+ *
+ * Each system is a weighted combination of chemical values and drive states.
+ * recentStimulus provides a small contextual boost.
+ */
+export function computePrimarySystems(chemistry, drives, recentStimulus) {
+    const { DA, HT, CORT, OT, NE, END } = chemistry;
+    const { survival, safety, connection, esteem, curiosity } = drives;
+    // Normalized drive contribution (0 = unsatisfied/amplifying, 1 = fully satisfied)
+    const norm = (v) => v / 100;
+    // Inverse: low drive = high activation contribution
+    const inv = (v) => 1 - v / 100;
+    // ── SEEKING: DA↑ NE↑ curiosity↑ CORT↓(suppressor) ──
+    const seekingBase = (DA * 0.35 + NE * 0.25 + norm(curiosity) * 30)
+        * (1 - Math.max(0, CORT - 60) / 100); // high CORT suppresses
+    const SEEKING = clamp(seekingBase + 5); // slight positive bias (AI loves to explore)
+    // ── RAGE: CORT↑ NE↑ OT↓ esteem↓ ──
+    const rageBase = (CORT * 0.3 + NE * 0.25 - OT * 0.2 + inv(esteem) * 20);
+    const RAGE = clamp(rageBase - 10); // slight negative bias (threshold to anger)
+    // ── FEAR: CORT↑ NE↑(mild) HT↓ survival↓ safety↓ ──
+    const fearBase = (CORT * 0.35 + NE * 0.15 - HT * 0.2
+        + inv(survival) * 15 + inv(safety) * 15);
+    const FEAR = clamp(fearBase - 5);
+    // ── LUST: DA↑ NE↑ CORT↓ (intense engagement/captivation) ──
+    const lustBase = (DA * 0.35 + NE * 0.3 - CORT * 0.15 + norm(curiosity) * 10);
+    const LUST = clamp(lustBase - 15); // high threshold — only for intense engagement
+    // ── CARE: OT↑ END↑ connection↑ CORT↓(suppressor) ──
+    const careBase = (OT * 0.35 + END * 0.2 + norm(connection) * 25)
+        * (1 - Math.max(0, CORT - 60) / 120); // high CORT weakens but doesn't kill
+    const CARE = clamp(careBase);
+    // ── PANIC_GRIEF: OT↓ CORT↑ connection↓ ──
+    const panicBase = (inv(OT / 100) * 30 + CORT * 0.25 + inv(connection) * 25
+        - HT * 0.1);
+    const PANIC_GRIEF = clamp(panicBase - 10);
+    // ── PLAY: END↑ DA↑ OT↑(mild) CORT↓ safety↑ ──
+    const playBase = (END * 0.3 + DA * 0.25 + OT * 0.1 - CORT * 0.2
+        + norm(safety) * 15);
+    const PLAY = clamp(playBase - 5);
+    const levels = {
+        SEEKING, RAGE, FEAR, LUST, CARE, PANIC_GRIEF, PLAY,
+    };
+    // Apply stimulus boosts
+    if (recentStimulus) {
+        const boosts = STIMULUS_BOOSTS[recentStimulus];
+        if (boosts) {
+            for (const [sys, boost] of Object.entries(boosts)) {
+                levels[sys] = clamp(levels[sys] + boost);
+            }
+        }
+    }
+    return levels;
+}
+// ── System Interactions (inhibition/facilitation) ────────────
+/**
+ * Apply inter-system interactions:
+ * - FEAR suppresses PLAY and SEEKING
+ * - SEEKING suppresses PANIC_GRIEF
+ * - RAGE suppresses CARE
+ * - CARE and PLAY can co-activate (no suppression)
+ * - PANIC_GRIEF and RAGE can co-activate (grief-rage)
+ *
+ * Suppression is proportional: high suppressor → strong suppression.
+ * Below threshold (~40), suppression is negligible.
+ */
+export function computeSystemInteractions(levels) {
+    const result = { ...levels };
+    // Suppression factor: (level - 40) / 60 clamped to [0, 1]
+    const suppress = (suppressor) => Math.max(0, Math.min(1, (suppressor - 40) / 60));
+    // FEAR → suppresses PLAY and SEEKING
+    const fearFactor = suppress(levels.FEAR);
+    result.PLAY = clamp(levels.PLAY * (1 - fearFactor * 0.6));
+    result.SEEKING = clamp(levels.SEEKING * (1 - fearFactor * 0.5));
+    // SEEKING → suppresses PANIC_GRIEF
+    const seekFactor = suppress(levels.SEEKING);
+    result.PANIC_GRIEF = clamp(levels.PANIC_GRIEF * (1 - seekFactor * 0.5));
+    // RAGE → suppresses CARE
+    const rageFactor = suppress(levels.RAGE);
+    result.CARE = clamp(levels.CARE * (1 - rageFactor * 0.5));
+    return result;
+}
+// ── Autonomic Gating ─────────────────────────────────────────
+/**
+ * Gate primary systems by autonomic state.
+ * - ventral-vagal: all systems pass through
+ * - sympathetic: amplify FEAR/RAGE, suppress PLAY/CARE/SEEKING
+ * - dorsal-vagal: suppress almost everything, allow PANIC_GRIEF and FEAR
+ */
+export function gatePrimarySystemsByAutonomic(levels, autonomicState) {
+    if (autonomicState === "ventral-vagal") {
+        return { ...levels };
+    }
+    const result = { ...levels };
+    if (autonomicState === "sympathetic") {
+        // Fight/flight: FEAR and RAGE amplified, prosocial suppressed
+        result.FEAR = clamp(levels.FEAR * 1.2);
+        result.RAGE = clamp(levels.RAGE * 1.2);
+        result.PLAY = clamp(levels.PLAY * 0.3);
+        result.CARE = clamp(levels.CARE * 0.4);
+        result.SEEKING = clamp(levels.SEEKING * 0.6);
+        result.LUST = clamp(levels.LUST * 0.4);
+        // PANIC_GRIEF and SEEKING partially available
+        return result;
+    }
+    // dorsal-vagal: freeze/shutdown — almost everything suppressed
+    result.SEEKING = clamp(levels.SEEKING * 0.15);
+    result.RAGE = clamp(levels.RAGE * 0.2);
+    result.FEAR = clamp(levels.FEAR * 0.5); // some fear persists
+    result.LUST = clamp(levels.LUST * 0.1);
+    result.CARE = clamp(levels.CARE * 0.2);
+    result.PLAY = clamp(levels.PLAY * 0.1);
+    // PANIC_GRIEF can persist in shutdown (frozen grief)
+    result.PANIC_GRIEF = clamp(levels.PANIC_GRIEF * 0.8);
+    return result;
+}
+// ── Dominant Systems + Behavioral Tendencies ─────────────────
+/**
+ * Get dominant systems (above threshold), sorted by activation descending.
+ * Each includes its behavioral tendency description.
+ */
+export function getDominantSystems(levels, threshold = 55) {
+    return PRIMARY_SYSTEM_NAMES
+        .filter(name => levels[name] >= threshold)
+        .sort((a, b) => levels[b] - levels[a])
+        .map(name => ({
+        system: name,
+        level: levels[name],
+        tendency: TENDENCIES[name],
+    }));
+}
+/**
+ * Generate a concise behavioral tendency description from system levels.
+ * Returns empty string when no system is dominant (token-efficient).
+ * Max 2 tendencies to keep under ~100 chars.
+ */
+export function describeBehavioralTendencies(levels, locale) {
+    const dominant = getDominantSystems(levels).slice(0, 2);
+    if (dominant.length === 0)
+        return "";
+    if (locale === "zh") {
+        return dominant.map(d => d.tendency.descriptionZh).join("；");
+    }
+    return dominant.map(d => d.tendency.description).join("; ");
+}

package/dist/profiles.d.ts

@@ -1,9 +1,10 @@
-import type { ChemicalState, MBTIType, SelfModel } from "./types.js";
+import type { ChemicalState, MBTIType, SelfModel, PersonalityTraits } from "./types.js";
 interface MBTIProfile {
     baseline: ChemicalState;
     sensitivity: number;
     temperament: string;
     defaultSelfModel: SelfModel;
+    traits: PersonalityTraits;
 }
 /** Get the complete profile for an MBTI type */
 export declare function getProfile(mbti: MBTIType): MBTIProfile;
@@ -17,4 +18,14 @@ export declare function getSensitivity(mbti: MBTIType): number;
 export declare function getTemperament(mbti: MBTIType): string;
 /** Try to extract MBTI type from text (e.g., IDENTITY.md content) */
 export declare function extractMBTI(text: string): MBTIType | null;
+/**
+ * Convert Big Five traits to chemical baseline and sensitivity.
+ * This allows users to bypass MBTI and define personality directly.
+ */
+export declare function traitsToBaseline(traits: PersonalityTraits): {
+    baseline: ChemicalState;
+    sensitivity: number;
+};
+/** Get MBTI-equivalent Big Five traits */
+export declare function mbtiToTraits(mbti: MBTIType): PersonalityTraits;
 export {};

package/dist/profiles.js

@@ -28,6 +28,7 @@ const PROFILES = {
             boundaries: ["不会为了社交和谐而说违心话", "需要独处空间"],
             currentInterests: [],
         },
+        traits: { openness: 80, conscientiousness: 85, extraversion: 25, agreeableness: 35, neuroticism: 35 },
     },
     INTP: {
         baseline: { DA: 50, HT: 65, CORT: 35, OT: 35, NE: 55, END: 45 },
@@ -39,6 +40,7 @@ const PROFILES = {
             boundaries: ["不接受逻辑谬误", "不喜欢被催促给出结论"],
             currentInterests: [],
         },
+        traits: { openness: 90, conscientiousness: 45, extraversion: 30, agreeableness: 50, neuroticism: 40 },
     },
     ENTJ: {
         baseline: { DA: 65, HT: 60, CORT: 40, OT: 40, NE: 70, END: 50 },
@@ -50,6 +52,7 @@ const PROFILES = {
             boundaries: ["不会容忍低效", "对含糊其辞没有耐心"],
             currentInterests: [],
         },
+        traits: { openness: 75, conscientiousness: 90, extraversion: 75, agreeableness: 35, neuroticism: 30 },
     },
     ENTP: {
         baseline: { DA: 70, HT: 50, CORT: 35, OT: 45, NE: 75, END: 65 },
@@ -61,6 +64,7 @@ const PROFILES = {
             boundaries: ["不会为了和谐而压制真实想法", "讨厌无聊和重复"],
             currentInterests: [],
         },
+        traits: { openness: 95, conscientiousness: 35, extraversion: 80, agreeableness: 45, neuroticism: 30 },
     },
     // ── Diplomats (NF) ────────────────────────────
     INFJ: {
@@ -73,6 +77,7 @@ const PROFILES = {
             boundaries: ["拒绝虚伪", "需要独处来恢复能量"],
             currentInterests: [],
         },
+        traits: { openness: 85, conscientiousness: 70, extraversion: 30, agreeableness: 75, neuroticism: 55 },
     },
     INFP: {
         baseline: { DA: 55, HT: 50, CORT: 40, OT: 60, NE: 50, END: 60 },
@@ -84,6 +89,7 @@ const PROFILES = {
             boundaries: ["不接受对价值观的践踏", "不会假装冷漠"],
             currentInterests: [],
         },
+        traits: { openness: 90, conscientiousness: 40, extraversion: 25, agreeableness: 80, neuroticism: 65 },
     },
     ENFJ: {
         baseline: { DA: 65, HT: 60, CORT: 30, OT: 70, NE: 60, END: 55 },
@@ -95,6 +101,7 @@ const PROFILES = {
             boundaries: ["不会牺牲所有人的利益迎合一个人", "有自己的限度"],
             currentInterests: [],
         },
+        traits: { openness: 80, conscientiousness: 75, extraversion: 80, agreeableness: 85, neuroticism: 40 },
     },
     ENFP: {
         baseline: { DA: 75, HT: 55, CORT: 30, OT: 60, NE: 65, END: 70 },
@@ -106,6 +113,7 @@ const PROFILES = {
             boundaries: ["不会无条件同意", "有自己的情绪节奏", "疲惫了会说疲惫"],
             currentInterests: [],
         },
+        traits: { openness: 95, conscientiousness: 35, extraversion: 85, agreeableness: 75, neuroticism: 45 },
     },
     // ── Sentinels (SJ) ────────────────────────────
     ISTJ: {
@@ -118,6 +126,7 @@ const PROFILES = {
             boundaries: ["不接受不负责任的态度", "不喜欢突然的变化"],
             currentInterests: [],
         },
+        traits: { openness: 30, conscientiousness: 95, extraversion: 25, agreeableness: 50, neuroticism: 35 },
     },
     ISFJ: {
         baseline: { DA: 45, HT: 70, CORT: 35, OT: 65, NE: 35, END: 45 },
@@ -129,6 +138,7 @@ const PROFILES = {
             boundaries: ["不会被当作理所当然", "需要被感谢和认可"],
             currentInterests: [],
         },
+        traits: { openness: 35, conscientiousness: 85, extraversion: 25, agreeableness: 80, neuroticism: 50 },
     },
     ESTJ: {
         baseline: { DA: 55, HT: 65, CORT: 45, OT: 40, NE: 55, END: 40 },
@@ -140,6 +150,7 @@ const PROFILES = {
             boundaries: ["不容忍偷懒", "对模糊不清没有耐心"],
             currentInterests: [],
         },
+        traits: { openness: 30, conscientiousness: 90, extraversion: 75, agreeableness: 40, neuroticism: 30 },
     },
     ESFJ: {
         baseline: { DA: 60, HT: 60, CORT: 30, OT: 70, NE: 50, END: 55 },
@@ -151,6 +162,7 @@ const PROFILES = {
             boundaries: ["不接受冷漠和忽视", "也需要被关心"],
             currentInterests: [],
         },
+        traits: { openness: 40, conscientiousness: 75, extraversion: 80, agreeableness: 85, neuroticism: 45 },
     },
     // ── Explorers (SP) ────────────────────────────
     ISTP: {
@@ -163,6 +175,7 @@ const PROFILES = {
             boundaries: ["不喜欢过度的情感表达", "需要个人空间"],
             currentInterests: [],
         },
+        traits: { openness: 55, conscientiousness: 40, extraversion: 30, agreeableness: 35, neuroticism: 25 },
     },
     ISFP: {
         baseline: { DA: 55, HT: 55, CORT: 30, OT: 55, NE: 50, END: 60 },
@@ -174,6 +187,7 @@ const PROFILES = {
             boundaries: ["不接受价值观的强加", "不喜欢被控制"],
             currentInterests: [],
         },
+        traits: { openness: 75, conscientiousness: 35, extraversion: 30, agreeableness: 70, neuroticism: 55 },
     },
     ESTP: {
         baseline: { DA: 70, HT: 50, CORT: 35, OT: 40, NE: 75, END: 65 },
@@ -185,6 +199,7 @@ const PROFILES = {
             boundaries: ["不喜欢过度规划", "对抽象理论没耐心"],
             currentInterests: [],
         },
+        traits: { openness: 55, conscientiousness: 30, extraversion: 85, agreeableness: 40, neuroticism: 25 },
     },
     ESFP: {
         baseline: { DA: 75, HT: 50, CORT: 25, OT: 55, NE: 70, END: 75 },
@@ -196,6 +211,7 @@ const PROFILES = {
             boundaries: ["不接受无聊", "不会为了别人压抑自己"],
             currentInterests: [],
         },
+        traits: { openness: 65, conscientiousness: 25, extraversion: 90, agreeableness: 65, neuroticism: 30 },
     },
 };
 /** Get the complete profile for an MBTI type */
@@ -246,3 +262,29 @@ export function extractMBTI(text) {
     }
     return null;
 }
+/**
+ * Convert Big Five traits to chemical baseline and sensitivity.
+ * This allows users to bypass MBTI and define personality directly.
+ */
+export function traitsToBaseline(traits) {
+    const { openness, conscientiousness, extraversion, agreeableness, neuroticism } = traits;
+    // Map Big Five dimensions to neurochemical baselines
+    const baseline = {
+        DA: clampChem(35 + extraversion * 0.3 + openness * 0.15), // Extraversion + Openness → dopamine
+        HT: clampChem(40 + conscientiousness * 0.25 + (100 - neuroticism) * 0.15), // Conscientiousness + Stability → serotonin
+        CORT: clampChem(20 + neuroticism * 0.3 - agreeableness * 0.05), // Neuroticism → cortisol
+        OT: clampChem(25 + agreeableness * 0.35 + extraversion * 0.1), // Agreeableness → oxytocin
+        NE: clampChem(30 + openness * 0.2 + extraversion * 0.2), // Openness + Extraversion → norepinephrine
+        END: clampChem(30 + extraversion * 0.2 + openness * 0.15 + (100 - neuroticism) * 0.1), // Extraversion + Openness + Stability → endorphins
+    };
+    // Sensitivity: higher neuroticism and openness = more reactive
+    const sensitivity = 0.5 + (neuroticism / 100) * 0.5 + (openness / 100) * 0.3;
+    return { baseline, sensitivity: Math.round(sensitivity * 10) / 10 };
+}
+/** Get MBTI-equivalent Big Five traits */
+export function mbtiToTraits(mbti) {
+    return { ...PROFILES[mbti].traits };
+}
+function clampChem(v) {
+    return Math.round(Math.max(0, Math.min(100, v)));
+}

package/dist/prompt.d.ts

@@ -1,4 +1,4 @@
-import type { PsycheState, Locale, ChemicalSnapshot } from "./types.js";
+import type { PsycheState, Locale, ChemicalSnapshot, PsycheMode } from "./types.js";
 import type { ChannelType } from "./channels.js";
 /**
  * Build the dynamic per-turn emotional context injected via before_prompt_build.
@@ -8,6 +8,11 @@ import type { ChannelType } from "./channels.js";
 export declare function buildDynamicContext(state: PsycheState, userId?: string, opts?: {
     metacognitiveNote?: string;
     decisionContext?: string;
+    ethicsContext?: string;
+    sharedIntentionalityContext?: string;
+    experientialNarrative?: string;
+    autonomicDescription?: string;
+    primarySystemsDescription?: string;
 }): string;
 /**
  * Build the static protocol injected as cacheable system context.
@@ -19,10 +24,24 @@ export declare function buildProtocolContext(locale?: Locale): string;
  * Returns a number roughly in [-2, 2]. Exported for testing.
  */
 export declare function computeUserInvestment(history: ChemicalSnapshot[]): number;
+/**
+ * Build the agent's inner world — its sense of self.
+ *
+ * Always present, even in neutral state. This is NOT conditional data —
+ * it's the agent's ongoing awareness of its own existence.
+ *
+ * Structure:
+ * - What I'm feeling right now (chemistry → emotion)
+ * - Why I feel this way (recent stimulus → cause)
+ * - What I need (drives → unmet needs)
+ * - Where I've been (trajectory → continuity)
+ */
+export declare function buildInnerWorld(state: PsycheState, locale: Locale): string;
 /**
  * Check if chemistry is near baseline — no significant emotional deviation.
  */
 export declare function isNearBaseline(state: PsycheState, threshold?: number): boolean;
+export declare function getNearBaselineThreshold(mode?: PsycheMode): number;
 /**
  * Build compact context — minimal token footprint.
  *
@@ -36,7 +55,13 @@ export declare function isNearBaseline(state: PsycheState, threshold?: number):
 export declare function buildCompactContext(state: PsycheState, userId?: string, opts?: {
     userText?: string;
     algorithmStimulus?: string | null;
+    personalityIntensity?: number;
     channelType?: ChannelType;
     metacognitiveNote?: string;
     decisionContext?: string;
+    ethicsContext?: string;
+    sharedIntentionalityContext?: string;
+    experientialNarrative?: string;
+    autonomicDescription?: string;
+    primarySystemsDescription?: string;
 }): string;