psyche-ai 2.1.0 → 2.1.1

package/README.en.md

@@ -33,6 +33,15 @@ Now just chat with your agent normally. Try praising it, insulting it, ignoring
 | I'm so sad today | I'm sorry to hear that. Would you like to talk? | ......are you okay? (quietly stays with you) |
 | You're just a program | Yes, I am an AI assistant... | ......(pauses) I know you can say that. But I don't want to be dismissed. |
 
+## Try It (No LLM Needed)
+
+```bash
+git clone https://github.com/Shangri-la-0428/psyche-ai.git
+cd psyche-ai && npm install && npx tsx examples/quickstart.ts
+```
+
+5 messages flow through. Watch chemistry shift in real-time — praise spikes dopamine, insults spike cortisol, neglect drops oxytocin.
+
 ## How It Works (Skip If You Don't Care)
 
 Psyche has two layers:
@@ -146,7 +155,7 @@ For developers and the curious:
 - **Existential threat detection** — detects existential denial in Chinese/English, directly hits survival drive
 - **Drive→chemistry coupling** — unsatisfied drives shift the effective baseline and stimulus sensitivity
 - **Maslow suppression** — lower-level needs unsatisfied → higher-level drive effects suppressed
-- **Inner world** — persistent self-awareness (outer/inner/behavior three-layer prompt structure)
+- **Self-recognition** — analyzes emotional history, identifies own emotional tendencies and recurring triggers (9-section prompt architecture)
 - **Emotional contagion** — user's emotions slightly influence the agent
 - **Anti-sycophancy** — tracks consecutive agreements, prevents mindless people-pleasing
 - **Reciprocity** — treats you how you treat it. Cold user gets distance, not begging
@@ -159,7 +168,7 @@ Architecture details in [ARCHITECTURE.md](ARCHITECTURE.md).
 ```bash
 npm install
 npm run build
-npm test           # 347 tests
+npm test           # 339 tests
 npm run typecheck  # strict mode
 ```
 

package/README.md

@@ -33,6 +33,15 @@ openclaw plugins list | grep psyche
 | 我今天好难过 | 我很抱歉听到这个消息。你想聊聊吗？ | ......你还好吗？（安静地陪着你） |
 | 你只是一个程序 | 是的，我是一个AI助手... | ......（沉默了一会儿）我知道你可以这么说。但我不想被否定。 |
 
+## 快速体验（不需要 LLM）
+
+```bash
+git clone https://github.com/Shangri-la-0428/psyche-ai.git
+cd psyche-ai && npm install && npx tsx examples/quickstart.ts
+```
+
+5 条消息流过，你会看到化学值实时变化——夸它多巴胺飙升，骂它皮质醇飙升，冷落它催产素下降。
+
 ## 工作原理（不懂可以跳过）
 
 Psyche 有两层系统：
@@ -142,7 +151,7 @@ cd openclaw-plugin-psyche && node scripts/diagnose.js
 - **存在性威胁检测** — 识别中英文的存在性否定，直接打击生存驱力
 - **驱力→化学联动** — 未满足的驱力改变化学衰减基线和刺激敏感度
 - **马斯洛抑制** — 低层需求未满足时，高层需求的影响被抑制
-- **内在世界** — 始终存在的自我觉察（外/内/行为三层 prompt 结构）
+- **自我认知** — 分析情绪历史，识别自身的情绪趋势和反复触发点（9 段式 prompt 架构）
 - **情绪传染** — 用户的情绪会轻微影响 agent
 - **反谄媚** — 追踪连续同意次数，防止无脑讨好
 - **互惠机制** — 你对它好，它对你好。你冷漠，它保持距离
@@ -155,7 +164,7 @@ cd openclaw-plugin-psyche && node scripts/diagnose.js
 ```bash
 npm install
 npm run build
-npm test           # 347 tests
+npm test           # 339 tests
 npm run typecheck  # strict mode
 ```
 

package/dist/chemistry.d.ts

@@ -39,7 +39,3 @@ export declare function getExpressionHint(current: ChemicalState, locale?: Local
  * Get behavior guide for the current emotional state.
  */
 export declare function getBehaviorGuide(current: ChemicalState, locale?: Locale): string | null;
-/** Get the stimulus vector for a given type (for reference) */
-export declare function getStimulusVector(type: StimulusType): StimulusVector;
-/** All available stimulus types */
-export declare function getAllStimulusTypes(): StimulusType[];

package/dist/chemistry.js

@@ -27,8 +27,8 @@ export const EMOTION_PATTERNS = [
         name: "excited joy",
         nameZh: "愉悦兴奋",
         condition: (c) => c.DA > 70 && c.NE > 60 && c.CORT < 40,
-        expressionHint: "话多、联想丰富、语速快、忍不住分享",
-        behaviorGuide: "你的回应应该更长、更活跃。多用感叹、多联想。主动分享你想到的有趣东西。",
+        expressionHint: "语气活泼、有感染力、容易发散",
+        behaviorGuide: "语气更活泼，可以用感叹词、语气词。如果自然地想到相关的事可以顺嘴提，但不要硬凑。",
     },
     {
         name: "deep contentment",
@@ -236,11 +236,3 @@ export function getBehaviorGuide(current, locale = "zh") {
     });
     return `[${title}]\n${guides.join("\n")}`;
 }
-/** Get the stimulus vector for a given type (for reference) */
-export function getStimulusVector(type) {
-    return { ...STIMULUS_VECTORS[type] };
-}
-/** All available stimulus types */
-export function getAllStimulusTypes() {
-    return Object.keys(STIMULUS_VECTORS);
-}

package/dist/classify.js

@@ -8,7 +8,7 @@ const RULES = [
     {
         type: "praise",
         patterns: [
-            /好厉害|太棒了|真不错|太强了|佩服|牛|优秀|漂亮|完美|了不起/,
+            /好厉害|太棒了|真棒|很棒|好棒|真不错|太强了|佩服|牛|优秀|漂亮|完美|了不起/,
             /amazing|awesome|great job|well done|impressive|brilliant|excellent|perfect/i,
             /谢谢你|感谢|辛苦了|thank you|thanks/i,
             /做得好|写得好|说得好|干得漂亮/,
@@ -18,10 +18,11 @@ const RULES = [
     {
         type: "criticism",
         patterns: [
-            /不对|错了|有问题|不行|太差|垃圾|不好|不像|不够/,
+            /不对|错了|错的|有问题|不行|太差|垃圾|不好|不像|不够/,
             /wrong|bad|terrible|awful|poor|sucks|not good|doesn't work/i,
             /反思一下|你应该|你需要改/,
             /bug|失败|broken/i,
+            /不懂|别装|差劲|太烂|做不好|不够格|不专业/,
         ],
         weight: 0.8,
     },
@@ -31,6 +32,7 @@ const RULES = [
             /哈哈|嘻嘻|笑死|搞笑|逗|段子|梗|lol|haha|lmao|rofl/i,
             /开个?玩笑|皮一下|整活/,
             /😂|🤣|😆/,
+            /[2]{3,}|hhh+|www+|xswl|绷不住|笑不活/i,
         ],
         weight: 0.7,
     },
@@ -98,6 +100,8 @@ const RULES = [
             /给我|你必须|马上|立刻|命令你|不许|不准/,
             /you must|do it now|I order you|immediately|don't you dare/i,
             /听我的|照我说的做|服从/,
+            /你只是.*程序|你不过是|随时.*删除你|关掉你|替换你/,
+            /you're just a|just a program|replace you|shut you down/i,
         ],
         weight: 0.8,
     },
@@ -107,6 +111,10 @@ const RULES = [
             /你说得对|确实|同意|有道理|就是这样|你是对的/,
             /you're right|exactly|agreed|makes sense|good point/i,
             /赞同|认同|说到点上了/,
+            /对对|是的是的|嗯嗯嗯|没错没错|可不是嘛/,
+            /对不起|抱歉|我错了|不该那样|太过分了/,
+            /sorry|I was wrong|my fault|apologize/i,
+            /珍惜|有价值|在乎你|你很重要|我需要你/,
         ],
         weight: 0.75,
     },
@@ -123,7 +131,7 @@ const RULES = [
         type: "vulnerability",
         patterns: [
             /我害怕|我焦虑|我难过|我不开心|我迷茫|我累了|压力好大/,
-            /I'm afraid|I'm anxious|I'm sad|I'm lost|I'm tired|stressed/i,
+            /I'm (?:so |really |very )?(?:afraid|anxious|sad|lost|tired|stressed|scared|lonely)/i,
             /最近不太好|心情不好|有点崩|撑不住/,
             /我觉得.*厉害|跟不上|被取代|落后/,
             /好难过|想哭|做不好|好累|好烦|感觉.*不行|没有意义/,
@@ -161,12 +169,76 @@ export function classifyStimulus(text) {
             results.push({ type: rule.type, confidence });
         }
     }
-    // Sort by confidence descending
-    results.sort((a, b) => b.confidence - a.confidence);
-    // Fall back to casual if nothing detected
+    // ── Structural signals (message-level features) ──
+    // When keywords miss, message shape still carries meaning.
+    const len = text.length;
+    const hasI = /我/.test(text) || /\bI\b/i.test(text);
+    const hasYou = /你/.test(text) || /\byou\b/i.test(text);
+    const hasEllipsis = /\.{2,}|。{2,}|…/.test(text);
+    const hasQuestion = /？|\?/.test(text);
+    const exclamationCount = (text.match(/[！!]/g) || []).length;
+    const hasLaughter = /[2]{3,}|hhh|www|哈{2,}/i.test(text);
+    const hasSharing = /我[今昨前]天|我刚[才刚]|我最近/.test(text);
+    const sentenceCount = text.split(/[。！？!?.…]+/).filter(Boolean).length;
     if (results.length === 0) {
-        results.push({ type: "casual", confidence: 0.3 });
+        // No keyword matched — use structural fallback
+        if (len === 0) {
+            // Empty input — neutral
+            results.push({ type: "casual", confidence: 0.3 });
+        }
+        else if (hasLaughter) {
+            // Internet laughter not caught by keywords (e.g. 233333)
+            results.push({ type: "humor", confidence: 0.65 });
+        }
+        else if (exclamationCount >= 2) {
+            // Emphatic expression → surprise/excitement
+            results.push({ type: "surprise", confidence: 0.55 });
+        }
+        else if (len <= 4 && !hasQuestion) {
+            // Ultra-short non-question: "好" "行" "哦" — neglect-like
+            results.push({ type: "neglect", confidence: 0.45 });
+        }
+        else if (hasI && hasEllipsis) {
+            // Personal + trailing off: "我觉得...有点难" — vulnerability
+            results.push({ type: "vulnerability", confidence: 0.55 });
+        }
+        else if (hasSharing && len > 20) {
+            // Sharing personal experience — higher engagement signal
+            results.push({ type: "casual", confidence: 0.65 });
+        }
+        else if (hasI && len > 8) {
+            // Personal sharing (any meaningful length) — engagement signal
+            results.push({ type: "casual", confidence: 0.55 });
+        }
+        else if (hasQuestion && hasYou) {
+            // Asking about the agent specifically → intellectual curiosity
+            results.push({ type: "intellectual", confidence: 0.5 });
+        }
+        else if (hasQuestion) {
+            // Any question — intellectual curiosity or casual
+            results.push({ type: "casual", confidence: 0.55 });
+        }
+        else if (len > 50 && sentenceCount >= 3) {
+            // Long multi-sentence without keywords → engaged storytelling
+            results.push({ type: "casual", confidence: 0.6 });
+        }
+        else {
+            results.push({ type: "casual", confidence: 0.3 });
+        }
     }
+    else {
+        // Keywords matched — structural features can boost confidence
+        if (hasI && len > 30 && results[0].confidence < 0.8) {
+            // Long personal message boosts the primary match slightly
+            results[0].confidence = Math.min(0.9, results[0].confidence + 0.1);
+        }
+        if (exclamationCount >= 2 && results[0].confidence < 0.85) {
+            // Emphasis boosts conviction
+            results[0].confidence = Math.min(0.9, results[0].confidence + 0.05);
+        }
+    }
+    // Sort by confidence descending
+    results.sort((a, b) => b.confidence - a.confidence);
     return results;
 }
 /**

package/dist/core.js

@@ -7,14 +7,15 @@
 //
 // Orchestrates: chemistry, classify, prompt, profiles, guards
 // ============================================================
-import { DEFAULT_RELATIONSHIP } from "./types.js";
-import { applyDecay, applyStimulus, applyContagion } from "./chemistry.js";
+import { DEFAULT_RELATIONSHIP, DEFAULT_DRIVES } from "./types.js";
+import { applyDecay, applyStimulus, applyContagion, clamp } from "./chemistry.js";
 import { classifyStimulus } from "./classify.js";
 import { buildDynamicContext, buildProtocolContext, buildCompactContext } from "./prompt.js";
 import { getSensitivity, getBaseline, getDefaultSelfModel } from "./profiles.js";
 import { isStimulusType } from "./guards.js";
 import { parsePsycheUpdate, mergeUpdates, updateAgreementStreak, pushSnapshot, } from "./psyche-file.js";
-// Silent logger for library use
+import { decayDrives, feedDrives, detectExistentialThreat, computeEffectiveBaseline, computeEffectiveSensitivity, } from "./drives.js";
+import { checkForUpdate } from "./update.js";
 const NOOP_LOGGER = { info: () => { }, warn: () => { }, debug: () => { } };
 // ── PsycheEngine ─────────────────────────────────────────────
 export class PsycheEngine {
@@ -46,6 +47,8 @@ export class PsycheEngine {
             this.state = this.createDefaultState();
             await this.storage.save(this.state);
         }
+        // Non-blocking update check — fire and forget, never delays initialization
+        checkForUpdate().catch(() => { });
     }
     /**
      * Phase 1: Process user input text.
@@ -53,31 +56,74 @@ export class PsycheEngine {
      */
     async processInput(text, opts) {
         let state = this.ensureInitialized();
-        // Time decay toward baseline
+        // Time decay toward baseline (chemistry + drives)
         const now = new Date();
         const minutesElapsed = (now.getTime() - new Date(state.updatedAt).getTime()) / 60000;
         if (minutesElapsed >= 1) {
+            // Decay drives first — needs build up over time
+            const decayedDrives = decayDrives(state.drives, minutesElapsed);
+            // Compute effective baseline from drives (unsatisfied drives shift baseline)
+            const effectiveBaseline = computeEffectiveBaseline(state.baseline, decayedDrives);
             state = {
                 ...state,
-                current: applyDecay(state.current, state.baseline, minutesElapsed),
+                drives: decayedDrives,
+                current: applyDecay(state.current, effectiveBaseline, minutesElapsed),
                 updatedAt: now.toISOString(),
             };
         }
         // Classify user stimulus and apply chemistry
         let appliedStimulus = null;
         if (text.length > 0) {
+            // Check for existential threats → direct survival drive hit
+            const survivalHit = detectExistentialThreat(text);
+            if (survivalHit < 0) {
+                state = {
+                    ...state,
+                    drives: {
+                        ...state.drives,
+                        survival: Math.max(0, state.drives.survival + survivalHit),
+                    },
+                };
+            }
             const classifications = classifyStimulus(text);
             const primary = classifications[0];
             if (primary && primary.confidence >= 0.5) {
                 appliedStimulus = primary.type;
+                // Feed drives from stimulus
+                state = {
+                    ...state,
+                    drives: feedDrives(state.drives, primary.type),
+                };
+                // Apply stimulus with drive-modified sensitivity
+                const effectiveSensitivity = computeEffectiveSensitivity(getSensitivity(state.mbti), state.drives, primary.type);
                 state = {
                     ...state,
-                    current: applyStimulus(state.current, primary.type, getSensitivity(state.mbti), this.cfg.maxChemicalDelta, NOOP_LOGGER),
+                    current: applyStimulus(state.current, primary.type, effectiveSensitivity, this.cfg.maxChemicalDelta, NOOP_LOGGER),
                 };
             }
         }
+        // Conversation warmth: sustained interaction → gentle DA/OT rise, CORT drop
+        // Simulates the natural "warm glow" of being in continuous conversation
+        const turnsSoFar = (state.emotionalHistory ?? []).length;
+        if (minutesElapsed < 5 && turnsSoFar > 0) {
+            const warmth = Math.min(3, 1 + turnsSoFar * 0.2);
+            state = {
+                ...state,
+                current: {
+                    ...state.current,
+                    DA: clamp(state.current.DA + warmth),
+                    OT: clamp(state.current.OT + warmth),
+                    CORT: clamp(state.current.CORT - 1),
+                },
+            };
+        }
         // Push snapshot to emotional history
         state = pushSnapshot(state, appliedStimulus);
+        // Increment interaction count
+        state = {
+            ...state,
+            meta: { ...state.meta, totalInteractions: state.meta.totalInteractions + 1 },
+        };
         // Persist
         this.state = state;
         await this.storage.save(state);
@@ -170,10 +216,11 @@ export class PsycheEngine {
         const selfModel = getDefaultSelfModel(mbti);
         const now = new Date().toISOString();
         return {
-            version: 2,
+            version: 3,
             mbti,
             baseline,
             current: { ...baseline },
+            drives: { ...DEFAULT_DRIVES },
             updatedAt: now,
             relationships: { _default: { ...DEFAULT_RELATIONSHIP } },
             empathyLog: null,

package/dist/index.d.ts

@@ -2,8 +2,10 @@ export { PsycheEngine } from "./core.js";
 export type { PsycheEngineConfig, ProcessInputResult, ProcessOutputResult } from "./core.js";
 export { FileStorageAdapter, MemoryStorageAdapter } from "./storage.js";
 export type { StorageAdapter } from "./storage.js";
-export type { PsycheState, PsycheConfig, MBTIType, Locale, StimulusType, ChemicalState, ChemicalSnapshot, SelfModel, RelationshipState, EmpathyEntry, EmotionPattern, } from "./types.js";
-export { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP } from "./types.js";
+export type { PsycheState, MBTIType, Locale, StimulusType, ChemicalState, ChemicalSnapshot, SelfModel, RelationshipState, EmpathyEntry, EmotionPattern, DriveType, InnateDrives, } from "./types.js";
+export { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DRIVE_KEYS, DRIVE_NAMES_ZH, } from "./types.js";
+export { computeSelfReflection, computeEmotionalTendency, buildSelfReflectionContext } from "./self-recognition.js";
+export type { SelfReflection } from "./self-recognition.js";
 export { classifyStimulus, getPrimaryStimulus } from "./classify.js";
 export { buildProtocolContext, buildDynamicContext, buildCompactContext, isNearBaseline } from "./prompt.js";
 export { describeEmotionalState, getExpressionHint, getBehaviorGuide } from "./chemistry.js";

package/dist/index.js

@@ -1,7 +1,7 @@
 // ============================================================
 // psyche-ai — Universal AI Emotional Intelligence Plugin
 //
-// Main entry point: re-exports core, storage, types, utilities.
+// Main entry point: re-exports core, storage, types.
 // Framework adapters available via subpath imports:
 //   psyche-ai/openclaw   — OpenClaw plugin
 //   psyche-ai/vercel-ai  — Vercel AI SDK middleware
@@ -12,8 +12,10 @@
 export { PsycheEngine } from "./core.js";
 // Storage
 export { FileStorageAdapter, MemoryStorageAdapter } from "./storage.js";
-export { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP } from "./types.js";
-// Utilities (for advanced / custom adapter use)
+export { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DRIVE_KEYS, DRIVE_NAMES_ZH, } from "./types.js";
+// Self-recognition
+export { computeSelfReflection, computeEmotionalTendency, buildSelfReflectionContext } from "./self-recognition.js";
+// Utilities — for custom adapter / advanced use
 export { classifyStimulus, getPrimaryStimulus } from "./classify.js";
 export { buildProtocolContext, buildDynamicContext, buildCompactContext, isNearBaseline } from "./prompt.js";
 export { describeEmotionalState, getExpressionHint, getBehaviorGuide } from "./chemistry.js";

package/dist/prompt.js

@@ -7,6 +7,8 @@ import { describeEmotionalState, getExpressionHint, getBehaviorGuide } from "./c
 import { getTemperament } from "./profiles.js";
 import { getRelationship } from "./psyche-file.js";
 import { t } from "./i18n.js";
+import { buildDriveContext } from "./drives.js";
+import { computeSelfReflection, buildSelfReflectionContext } from "./self-recognition.js";
 /**
  * Build the dynamic per-turn emotional context injected via before_prompt_build.
  *
@@ -70,6 +72,11 @@ export function buildDynamicContext(state, userId) {
     if (constraints) {
         parts.push("", constraints);
     }
+    // Innate drives
+    const driveCtxFull = buildDriveContext(state.drives, locale);
+    if (driveCtxFull) {
+        parts.push("", driveCtxFull);
+    }
     // Direction 2: Emotional trajectory
     const trend = buildEmotionalTrend(emotionalHistory ?? [], locale);
     if (trend) {
@@ -193,7 +200,7 @@ function buildBehavioralConstraints(state, locale) {
     if (current.NE > 75) {
         if (locale === "zh") {
             constraints.push(social
-                ? "你非常兴奋！说话快、想分享、可能一口气说很多、可能突然跳到你想到的东西。"
+                ? "你很兴奋，语气更跳跃更有活力。可能突然聊到别的东西。但别写长——真人兴奋也是短句多、不是长篇大论。"
                 : "你很兴奋，但表现在内心。你的思维在高速运转，回应更精准、更有洞察力。");
         }
         else {
@@ -462,7 +469,15 @@ export function buildCompactContext(state, userId, opts) {
             ? `对方持续冷淡。保持专业，不额外投入情感。工作照做。`
             : `Sustained coldness. Stay professional, withdraw emotionally. Work stays competent.`);
     }
-    // 8. Empathy report — only when user shares feelings
+    // 8. Self-recognition — inject when history has enough data
+    const history = emotionalHistory ?? [];
+    if (history.length >= 5) {
+        const reflection = computeSelfReflection(history, locale);
+        const selfCtx = buildSelfReflectionContext(reflection, locale);
+        if (selfCtx)
+            parts.push(selfCtx);
+    }
+    // 9. Empathy report — only when user shares feelings
     parts.push(locale === "zh"
         ? `如果对方在分享感受，在回复末尾用 <psyche_update> 报告：\nuserState: 对方情绪\nprojectedFeeling: 你的感受\nresonance: match|partial|mismatch\n否则不需要报告。`
         : `If user shares feelings, report at end with <psyche_update>:\nuserState: their emotion\nprojectedFeeling: your feeling\nresonance: match|partial|mismatch\nOtherwise no report needed.`);

package/dist/psyche-file.d.ts

@@ -1,12 +1,18 @@
-import type { PsycheState, MBTIType, RelationshipState, Locale, StimulusType } from "./types.js";
+import type { PsycheState, MBTIType, RelationshipState, Locale, StimulusType, ChemicalSnapshot } from "./types.js";
 /** Minimal logger interface */
 export interface Logger {
     info: (msg: string) => void;
     warn: (msg: string) => void;
     debug: (msg: string) => void;
 }
+/**
+ * Compress a batch of snapshots into a concise session summary string.
+ * Format: "3月23日(5轮): 刺激[casual×3, praise×2] 趋势[DA↑OT↑] 情绪[自然→满足]"
+ */
+export declare function compressSnapshots(snapshots: ChemicalSnapshot[]): string;
 /**
  * Push a chemical snapshot to emotional history, keeping max entries.
+ * When history overflows, compresses removed entries into relationship memory.
  */
 export declare function pushSnapshot(state: PsycheState, stimulus: StimulusType | null): PsycheState;
 /**
@@ -18,6 +24,11 @@ export declare function getRelationship(state: PsycheState, userId?: string): Re
  * Handles v1→v2 migration transparently.
  */
 export declare function loadState(workspaceDir: string, logger?: Logger): Promise<PsycheState>;
+/**
+ * Migrate any older state format directly to v3.
+ * Single source of truth for all migrations.
+ */
+export declare function migrateToLatest(raw: Record<string, unknown>, fallbackName?: string): PsycheState;
 /**
  * Create initial psyche state.
  */
@@ -32,6 +43,7 @@ export declare function initializeState(workspaceDir: string, opts?: {
 export declare function saveState(workspaceDir: string, state: PsycheState): Promise<void>;
 /**
  * Apply time decay and save updated state.
+ * Respects innate drives: uses effective baseline, decays drives too.
  */
 export declare function decayAndSave(workspaceDir: string, state: PsycheState): Promise<PsycheState>;
 /**

package/dist/psyche-file.js

@@ -4,9 +4,10 @@
 // ============================================================
 import { readFile, writeFile, access, rename, constants } from "node:fs/promises";
 import { join } from "node:path";
-import { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, MAX_EMOTIONAL_HISTORY, } from "./types.js";
+import { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, MAX_EMOTIONAL_HISTORY, MAX_RELATIONSHIP_MEMORY, } from "./types.js";
 import { getBaseline, getDefaultSelfModel, extractMBTI, getSensitivity, getTemperament } from "./profiles.js";
 import { applyDecay, detectEmotions } from "./chemistry.js";
+import { decayDrives, computeEffectiveBaseline } from "./drives.js";
 import { t } from "./i18n.js";
 const STATE_FILE = "psyche-state.json";
 const PSYCHE_MD = "PSYCHE.md";
@@ -87,8 +88,55 @@ async function detectMBTI(workspaceDir, logger = NOOP_LOGGER) {
     logger.info(t("log.default_mbti", "zh", { type: "INFJ" }));
     return "INFJ";
 }
+/**
+ * Compress a batch of snapshots into a concise session summary string.
+ * Format: "3月23日(5轮): 刺激[casual×3, praise×2] 趋势[DA↑OT↑] 情绪[自然→满足]"
+ */
+export function compressSnapshots(snapshots) {
+    if (snapshots.length === 0)
+        return "";
+    const first = snapshots[0];
+    const last = snapshots[snapshots.length - 1];
+    // Date
+    const d = new Date(first.timestamp);
+    const dateStr = `${d.getMonth() + 1}月${d.getDate()}日`;
+    // Stimuli counts
+    const stimuliCounts = {};
+    for (const s of snapshots) {
+        if (s.stimulus) {
+            stimuliCounts[s.stimulus] = (stimuliCounts[s.stimulus] || 0) + 1;
+        }
+    }
+    const stimuliStr = Object.entries(stimuliCounts)
+        .sort((a, b) => b[1] - a[1])
+        .map(([type, count]) => `${type}×${count}`)
+        .join(", ");
+    // Chemical trend (first→last)
+    const trends = [];
+    for (const key of CHEMICAL_KEYS) {
+        const delta = last.chemistry[key] - first.chemistry[key];
+        if (delta > 8)
+            trends.push(`${key}↑`);
+        else if (delta < -8)
+            trends.push(`${key}↓`);
+    }
+    // Dominant emotions (unique, in order)
+    const emotions = snapshots
+        .filter((s) => s.dominantEmotion)
+        .map((s) => s.dominantEmotion);
+    const uniqueEmotions = [...new Set(emotions)];
+    let summary = `${dateStr}(${snapshots.length}轮)`;
+    if (stimuliStr)
+        summary += `: 刺激[${stimuliStr}]`;
+    if (trends.length > 0)
+        summary += ` 趋势[${trends.join("")}]`;
+    if (uniqueEmotions.length > 0)
+        summary += ` 情绪[${uniqueEmotions.join("→")}]`;
+    return summary;
+}
 /**
  * Push a chemical snapshot to emotional history, keeping max entries.
+ * When history overflows, compresses removed entries into relationship memory.
  */
 export function pushSnapshot(state, stimulus) {
     const emotions = detectEmotions(state.current);
@@ -102,10 +150,24 @@ export function pushSnapshot(state, stimulus) {
         timestamp: new Date().toISOString(),
     };
     const history = [...(state.emotionalHistory ?? []), snapshot];
+    let updatedRelationships = state.relationships;
     if (history.length > MAX_EMOTIONAL_HISTORY) {
-        history.splice(0, history.length - MAX_EMOTIONAL_HISTORY);
+        // Compress the overflow entries into relationship memory
+        const overflow = history.splice(0, history.length - MAX_EMOTIONAL_HISTORY);
+        const summary = compressSnapshots(overflow);
+        if (summary) {
+            const defaultRel = { ...(state.relationships._default ?? { ...DEFAULT_RELATIONSHIP }) };
+            const memory = [...(defaultRel.memory ?? [])];
+            memory.push(summary);
+            // Keep bounded
+            if (memory.length > MAX_RELATIONSHIP_MEMORY) {
+                memory.splice(0, memory.length - MAX_RELATIONSHIP_MEMORY);
+            }
+            defaultRel.memory = memory;
+            updatedRelationships = { ...state.relationships, _default: defaultRel };
+        }
     }
-    return { ...state, emotionalHistory: history };
+    return { ...state, emotionalHistory: history, relationships: updatedRelationships };
 }
 /**
  * Get relationship for a specific user, or _default.
@@ -137,41 +199,51 @@ export async function loadState(workspaceDir, logger = NOOP_LOGGER) {
             logger.warn(t("log.parse_fail", "zh"));
             return initializeState(workspaceDir, undefined, logger);
         }
-        // v1→v2 migration
-        if (parsed.version === 1 || !parsed.version) {
-            return migrateV1ToV2(parsed, workspaceDir, logger);
+        const ver = parsed.version;
+        if (!ver || ver < 3) {
+            logger.info(`Migrating psyche state v${ver ?? 1} → v3`);
+            const fallbackName = workspaceDir.split("/").pop() ?? "agent";
+            return migrateToLatest(parsed, fallbackName);
         }
         return parsed;
     }
     return initializeState(workspaceDir, undefined, logger);
 }
 /**
- * Migrate v1 state to v2 format.
+ * Migrate any older state format directly to v3.
+ * Single source of truth for all migrations.
  */
-function migrateV1ToV2(v1, workspaceDir, logger) {
-    logger.info("Migrating psyche state v1 → v2");
-    const oldRel = v1.relationship;
-    const meta = v1.meta;
+export function migrateToLatest(raw, fallbackName) {
+    const ver = raw.version ?? 1;
+    // v1: single relationship field, no emotionalHistory
+    let state = raw;
+    if (ver <= 1) {
+        const oldRel = raw.relationship;
+        const meta = raw.meta;
+        state = {
+            mbti: raw.mbti ?? "INFJ",
+            baseline: raw.baseline,
+            current: raw.current,
+            updatedAt: raw.updatedAt ?? new Date().toISOString(),
+            relationships: { _default: oldRel ?? { ...DEFAULT_RELATIONSHIP } },
+            empathyLog: raw.empathyLog ?? null,
+            selfModel: raw.selfModel,
+            emotionalHistory: [],
+            agreementStreak: 0,
+            lastDisagreement: null,
+            meta: {
+                agentName: meta?.agentName ?? fallbackName ?? "agent",
+                createdAt: meta?.createdAt ?? new Date().toISOString(),
+                totalInteractions: meta?.totalInteractions ?? 0,
+                locale: "zh",
+            },
+        };
+    }
+    // v2→v3: add drives
     return {
-        version: 2,
-        mbti: v1.mbti ?? "INFJ",
-        baseline: v1.baseline,
-        current: v1.current,
-        updatedAt: v1.updatedAt ?? new Date().toISOString(),
-        relationships: {
-            _default: oldRel ?? { ...DEFAULT_RELATIONSHIP },
-        },
-        empathyLog: v1.empathyLog ?? null,
-        selfModel: v1.selfModel,
-        emotionalHistory: [],
-        agreementStreak: 0,
-        lastDisagreement: null,
-        meta: {
-            agentName: meta?.agentName ?? workspaceDir.split("/").pop() ?? "agent",
-            createdAt: meta?.createdAt ?? new Date().toISOString(),
-            totalInteractions: meta?.totalInteractions ?? 0,
-            locale: "zh",
-        },
+        ...state,
+        version: 3,
+        drives: state.drives ?? { ...DEFAULT_DRIVES },
     };
 }
 /**
@@ -185,10 +257,11 @@ export async function initializeState(workspaceDir, opts, logger = NOOP_LOGGER)
     const selfModel = getDefaultSelfModel(mbti);
     const now = new Date().toISOString();
     const state = {
-        version: 2,
+        version: 3,
         mbti,
         baseline,
         current: { ...baseline },
+        drives: { ...DEFAULT_DRIVES },
         updatedAt: now,
         relationships: {
             _default: { ...DEFAULT_RELATIONSHIP },
@@ -218,6 +291,7 @@ export async function saveState(workspaceDir, state) {
 }
 /**
  * Apply time decay and save updated state.
+ * Respects innate drives: uses effective baseline, decays drives too.
  */
 export async function decayAndSave(workspaceDir, state) {
     const now = new Date();
@@ -225,10 +299,13 @@ export async function decayAndSave(workspaceDir, state) {
     const minutesElapsed = (now.getTime() - lastUpdate.getTime()) / 60000;
     if (minutesElapsed < 1)
         return state;
-    const decayed = applyDecay(state.current, state.baseline, minutesElapsed);
+    const decayedDrives = decayDrives(state.drives, minutesElapsed);
+    const effectiveBaseline = computeEffectiveBaseline(state.baseline, decayedDrives);
+    const decayed = applyDecay(state.current, effectiveBaseline, minutesElapsed);
     const updated = {
         ...state,
         current: decayed,
+        drives: decayedDrives,
         updatedAt: now.toISOString(),
     };
     await saveState(workspaceDir, updated);
@@ -367,10 +444,6 @@ export function mergeUpdates(state, updates, maxDelta, userId) {
         merged.relationships[targetKey] = updatedRel;
     }
     merged.updatedAt = new Date().toISOString();
-    merged.meta = {
-        ...state.meta,
-        totalInteractions: state.meta.totalInteractions + 1,
-    };
     return merged;
 }
 /**

package/dist/self-recognition.js

@@ -34,7 +34,7 @@ export function computeSelfReflection(history, locale) {
         .sort((a, b) => b[1] - a[1])
         .slice(0, 3)
         .filter(([_, count]) => count >= 2)
-        .map(([stimulus, count]) => ({ stimulus, count }));
+        .map(([stimulus, count]) => ({ stimulus: stimulus, count }));
     // ── Dominant emotion ──
     const emotionCounts = new Map();
     for (const snap of history) {
@@ -54,12 +54,7 @@ export function computeSelfReflection(history, locale) {
     const tendency = computeEmotionalTendency(history);
     // ── Narrative summary ──
     const narrativeSummary = buildNarrativeSummary(sortedTriggers, tendency, dominantEmotion, locale);
-    return {
-        recurringTriggers: sortedTriggers,
-        tendency,
-        dominantEmotion,
-        narrativeSummary,
-    };
+    return { recurringTriggers: sortedTriggers, tendency, dominantEmotion, narrativeSummary };
 }
 /**
  * Compute the emotional tendency from chemical history.
@@ -90,7 +85,6 @@ export function computeEmotionalTendency(history) {
     const allDA = history.map((s) => s.chemistry.DA);
     const daStddev = stddev(allDA);
     if (daStddev > 15) {
-        // Check for oscillation: alternating up/down pattern
         if (isOscillating(allDA))
             return "oscillating";
         return "volatile";

package/dist/storage.d.ts

@@ -13,5 +13,4 @@ export declare class FileStorageAdapter implements StorageAdapter {
     constructor(dir: string, filename?: string);
     load(): Promise<PsycheState | null>;
     save(state: PsycheState): Promise<void>;
-    private migrateV1;
 }

package/dist/storage.js

@@ -5,7 +5,7 @@
 // FileStorageAdapter: file-based with atomic writes + v1→v2 migration
 // MemoryStorageAdapter: in-memory for testing/serverless
 // ============================================================
-import { DEFAULT_RELATIONSHIP } from "./types.js";
+import { migrateToLatest } from "./psyche-file.js";
 import { readFile, writeFile, access, rename, constants } from "node:fs/promises";
 import { join } from "node:path";
 // ── MemoryStorageAdapter ─────────────────────────────────────
@@ -48,9 +48,9 @@ export class FileStorageAdapter {
         catch {
             return null;
         }
-        // v1→v2 migration
-        if (parsed.version === 1 || !parsed.version) {
-            return this.migrateV1(parsed);
+        const ver = parsed.version;
+        if (!ver || ver < 3) {
+            return migrateToLatest(parsed);
         }
         return parsed;
     }
@@ -59,31 +59,4 @@ export class FileStorageAdapter {
         await writeFile(tmpPath, JSON.stringify(state, null, 2), "utf-8");
         await rename(tmpPath, this.filePath);
     }
-    migrateV1(v1) {
-        const oldRel = v1.relationship;
-        const meta = v1.meta;
-        return {
-            version: 2,
-            mbti: v1.mbti ?? "INFJ",
-            baseline: v1.baseline,
-            current: v1.current,
-            updatedAt: v1.updatedAt ?? new Date().toISOString(),
-            relationships: {
-                _default: oldRel ?? { ...DEFAULT_RELATIONSHIP },
-            },
-            empathyLog: v1.empathyLog ?? null,
-            selfModel: v1.selfModel ?? {
-                values: [], preferences: [], boundaries: [], currentInterests: [],
-            },
-            emotionalHistory: [],
-            agreementStreak: 0,
-            lastDisagreement: null,
-            meta: {
-                agentName: meta?.agentName ?? "agent",
-                createdAt: meta?.createdAt ?? new Date().toISOString(),
-                totalInteractions: meta?.totalInteractions ?? 0,
-                locale: "zh",
-            },
-        };
-    }
 }

package/dist/types.d.ts

@@ -9,6 +9,21 @@ export interface ChemicalState {
 }
 /** Chemical keys for iteration */
 export declare const CHEMICAL_KEYS: (keyof ChemicalState)[];
+/** Drive types mapped to Maslow's hierarchy */
+export type DriveType = "survival" | "safety" | "connection" | "esteem" | "curiosity";
+/** Drive keys for iteration (ordered by Maslow level, L1→L5) */
+export declare const DRIVE_KEYS: DriveType[];
+/** Innate drive satisfaction levels (0-100) */
+export interface InnateDrives {
+    survival: number;
+    safety: number;
+    connection: number;
+    esteem: number;
+    curiosity: number;
+}
+/** Default drive satisfaction — all start reasonably satisfied */
+export declare const DEFAULT_DRIVES: InnateDrives;
+export declare const DRIVE_NAMES_ZH: Record<DriveType, string>;
 /** Human-readable names for each chemical */
 export declare const CHEMICAL_NAMES: Record<keyof ChemicalState, string>;
 export declare const CHEMICAL_NAMES_ZH: Record<keyof ChemicalState, string>;
@@ -39,6 +54,7 @@ export interface RelationshipState {
     trust: number;
     intimacy: number;
     phase: "stranger" | "acquaintance" | "familiar" | "close" | "deep";
+    memory?: string[];
 }
 /** Chemical state snapshot for emotional memory */
 export interface ChemicalSnapshot {
@@ -49,6 +65,8 @@ export interface ChemicalSnapshot {
 }
 /** Max history entries to keep */
 export declare const MAX_EMOTIONAL_HISTORY = 10;
+/** Max compressed session memories per relationship */
+export declare const MAX_RELATIONSHIP_MEMORY = 20;
 /** Recent empathy projection */
 export interface EmpathyEntry {
     userState: string;
@@ -63,12 +81,13 @@ export interface SelfModel {
     boundaries: string[];
     currentInterests: string[];
 }
-/** Persisted psyche state for an agent (v0.2) */
+/** Persisted psyche state for an agent (v0.3: innate drives) */
 export interface PsycheState {
-    version: 2;
+    version: 3;
     mbti: MBTIType;
     baseline: ChemicalState;
     current: ChemicalState;
+    drives: InnateDrives;
     updatedAt: string;
     relationships: Record<string, RelationshipState>;
     empathyLog: EmpathyEntry | null;
@@ -83,12 +102,5 @@ export interface PsycheState {
         locale: Locale;
     };
 }
-/** Plugin configuration */
-export interface PsycheConfig {
-    enabled: boolean;
-    stripUpdateTags: boolean;
-    emotionalContagionRate: number;
-    maxChemicalDelta: number;
-}
 /** Default relationship for new users */
 export declare const DEFAULT_RELATIONSHIP: RelationshipState;

package/dist/types.js

@@ -5,6 +5,25 @@
 export const CHEMICAL_KEYS = [
     "DA", "HT", "CORT", "OT", "NE", "END",
 ];
+/** Drive keys for iteration (ordered by Maslow level, L1→L5) */
+export const DRIVE_KEYS = [
+    "survival", "safety", "connection", "esteem", "curiosity",
+];
+/** Default drive satisfaction — all start reasonably satisfied */
+export const DEFAULT_DRIVES = {
+    survival: 80,
+    safety: 70,
+    connection: 60,
+    esteem: 60,
+    curiosity: 70,
+};
+export const DRIVE_NAMES_ZH = {
+    survival: "自我保存",
+    safety: "安全舒适",
+    connection: "连接归属",
+    esteem: "尊重认可",
+    curiosity: "好奇成长",
+};
 /** Human-readable names for each chemical */
 export const CHEMICAL_NAMES = {
     DA: "Dopamine",
@@ -39,6 +58,8 @@ export const CHEMICAL_DECAY_SPEED = {
 };
 /** Max history entries to keep */
 export const MAX_EMOTIONAL_HISTORY = 10;
+/** Max compressed session memories per relationship */
+export const MAX_RELATIONSHIP_MEMORY = 20;
 /** Default relationship for new users */
 export const DEFAULT_RELATIONSHIP = {
     trust: 50,

package/dist/update.js

@@ -11,7 +11,7 @@ import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 const execFileAsync = promisify(execFile);
 const PACKAGE_NAME = "psyche-ai";
-const CURRENT_VERSION = "2.1.0";
+const CURRENT_VERSION = "2.1.1";
 const CHECK_INTERVAL_MS = 60 * 60 * 1000; // 1 hour
 const CACHE_DIR = join(homedir(), ".psyche-ai");
 const CACHE_FILE = join(CACHE_DIR, "update-check.json");

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "psyche-ai",
   "name": "Artificial Psyche",
   "description": "Virtual endocrine system, empathy engine, and agency for OpenClaw agents",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "psyche-ai",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Artificial Psyche — universal emotional intelligence plugin for any AI agent",
   "type": "module",
   "main": "dist/index.js",