psyche-ai 2.0.0

package/dist/storage.js

@@ -0,0 +1,62 @@
+// ============================================================
+// Storage Adapters — Persistence layer for PsycheEngine
+//
+// StorageAdapter: interface for any storage backend
+// FileStorageAdapter: file-based with atomic writes + v1→v2 migration
+// MemoryStorageAdapter: in-memory for testing/serverless
+// ============================================================
+import { migrateToLatest } from "./psyche-file.js";
+import { readFile, writeFile, access, rename, constants } from "node:fs/promises";
+import { join } from "node:path";
+// ── MemoryStorageAdapter ─────────────────────────────────────
+export class MemoryStorageAdapter {
+    state = null;
+    async load() {
+        return this.state;
+    }
+    async save(state) {
+        this.state = state;
+    }
+}
+// ── FileStorageAdapter ───────────────────────────────────────
+export class FileStorageAdapter {
+    filePath;
+    constructor(dir, filename = "psyche-state.json") {
+        this.filePath = join(dir, filename);
+    }
+    async load() {
+        try {
+            await access(this.filePath, constants.R_OK);
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === "EACCES" || code === "EPERM")
+                throw err;
+            return null; // ENOENT — file doesn't exist
+        }
+        let raw;
+        try {
+            raw = await readFile(this.filePath, "utf-8");
+        }
+        catch {
+            return null;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+        const ver = parsed.version;
+        if (!ver || ver < 3) {
+            return migrateToLatest(parsed);
+        }
+        return parsed;
+    }
+    async save(state) {
+        const tmpPath = this.filePath + ".tmp";
+        await writeFile(tmpPath, JSON.stringify(state, null, 2), "utf-8");
+        await rename(tmpPath, this.filePath);
+    }
+}

package/dist/types.d.ts

@@ -0,0 +1,106 @@
+/** The six virtual neurotransmitters that compose emotional state */
+export interface ChemicalState {
+    DA: number;
+    HT: number;
+    CORT: number;
+    OT: number;
+    NE: number;
+    END: number;
+}
+/** 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>;
+/** Decay speed category */
+export type DecaySpeed = "fast" | "medium" | "slow";
+/** Decay factor per chemical (applied per hour) */
+export declare const DECAY_FACTORS: Record<DecaySpeed, number>;
+/** Which chemicals decay at which speed */
+export declare const CHEMICAL_DECAY_SPEED: Record<keyof ChemicalState, DecaySpeed>;
+/** MBTI type string */
+export type MBTIType = "INTJ" | "INTP" | "ENTJ" | "ENTP" | "INFJ" | "INFP" | "ENFJ" | "ENFP" | "ISTJ" | "ISFJ" | "ESTJ" | "ESFJ" | "ISTP" | "ISFP" | "ESTP" | "ESFP";
+/** Stimulus types that affect chemistry (v0.2: +5 new types) */
+export type StimulusType = "praise" | "criticism" | "humor" | "intellectual" | "intimacy" | "conflict" | "neglect" | "surprise" | "casual" | "sarcasm" | "authority" | "validation" | "boredom" | "vulnerability";
+/** Chemical effect vector for a stimulus */
+export type StimulusVector = Record<keyof ChemicalState, number>;
+/** Locale for i18n */
+export type Locale = "zh" | "en";
+/** Emergent emotion pattern (v0.2: +behaviorGuide) */
+export interface EmotionPattern {
+    name: string;
+    nameZh: string;
+    condition: (c: ChemicalState) => boolean;
+    expressionHint: string;
+    behaviorGuide: string;
+}
+/** Relationship tracking */
+export interface RelationshipState {
+    trust: number;
+    intimacy: number;
+    phase: "stranger" | "acquaintance" | "familiar" | "close" | "deep";
+    memory?: string[];
+}
+/** Chemical state snapshot for emotional memory */
+export interface ChemicalSnapshot {
+    chemistry: ChemicalState;
+    stimulus: StimulusType | null;
+    dominantEmotion: string | null;
+    timestamp: string;
+}
+/** 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;
+    projectedFeeling: string;
+    resonance: "match" | "partial" | "mismatch";
+    timestamp: string;
+}
+/** Agent's self-model (values, preferences, boundaries) */
+export interface SelfModel {
+    values: string[];
+    preferences: string[];
+    boundaries: string[];
+    currentInterests: string[];
+}
+/** Persisted psyche state for an agent (v0.3: innate drives) */
+export interface PsycheState {
+    version: 3;
+    mbti: MBTIType;
+    baseline: ChemicalState;
+    current: ChemicalState;
+    drives: InnateDrives;
+    updatedAt: string;
+    relationships: Record<string, RelationshipState>;
+    empathyLog: EmpathyEntry | null;
+    selfModel: SelfModel;
+    emotionalHistory: ChemicalSnapshot[];
+    agreementStreak: number;
+    lastDisagreement: string | null;
+    meta: {
+        agentName: string;
+        createdAt: string;
+        totalInteractions: number;
+        locale: Locale;
+    };
+}
+/** Default relationship for new users */
+export declare const DEFAULT_RELATIONSHIP: RelationshipState;

package/dist/types.js

@@ -0,0 +1,68 @@
+// ============================================================
+// Artificial Psyche — Type Definitions (v0.2)
+// ============================================================
+/** Chemical keys for iteration */
+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",
+    HT: "Serotonin",
+    CORT: "Cortisol",
+    OT: "Oxytocin",
+    NE: "Norepinephrine",
+    END: "Endorphins",
+};
+export const CHEMICAL_NAMES_ZH = {
+    DA: "多巴胺",
+    HT: "血清素",
+    CORT: "皮质醇",
+    OT: "催产素",
+    NE: "去甲肾上腺素",
+    END: "内啡肽",
+};
+/** Decay factor per chemical (applied per hour) */
+export const DECAY_FACTORS = {
+    fast: 0.7, // NE, END — excitement fades quickly
+    medium: 0.85, // DA, CORT — pleasure and stress take time
+    slow: 0.95, // HT, OT — mood and trust change slowly
+};
+/** Which chemicals decay at which speed */
+export const CHEMICAL_DECAY_SPEED = {
+    DA: "medium",
+    HT: "slow",
+    CORT: "medium",
+    OT: "slow",
+    NE: "fast",
+    END: "fast",
+};
+/** 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,
+    intimacy: 30,
+    phase: "acquaintance",
+};

package/openclaw.plugin.json

@@ -0,0 +1,60 @@
+{
+  "id": "psyche",
+  "name": "Artificial Psyche",
+  "description": "Virtual endocrine system, empathy engine, and agency for OpenClaw agents",
+  "version": "2.0.0",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "enabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable/disable the psyche system globally"
+      },
+      "stripUpdateTags": {
+        "type": "boolean",
+        "default": true,
+        "description": "Strip <psyche_update> tags from visible output"
+      },
+      "emotionalContagionRate": {
+        "type": "number",
+        "default": 0.2,
+        "description": "How much the user's emotions affect the agent (0-1)"
+      },
+      "maxChemicalDelta": {
+        "type": "number",
+        "default": 25,
+        "description": "Maximum chemical change per stimulus (emotional inertia)"
+      },
+      "compactMode": {
+        "type": "boolean",
+        "default": true,
+        "description": "Compact mode: algorithms handle chemistry, LLM only sees behavioral instructions (~15-180 tokens vs ~550)"
+      }
+    }
+  },
+  "uiHints": {
+    "enabled": {
+      "label": "Enable Psyche",
+      "sensitive": false,
+      "advanced": false
+    },
+    "stripUpdateTags": {
+      "label": "Hide Chemistry Updates",
+      "sensitive": false,
+      "advanced": true
+    },
+    "emotionalContagionRate": {
+      "label": "Emotional Contagion Rate",
+      "placeholder": "0.2",
+      "sensitive": false,
+      "advanced": true
+    },
+    "compactMode": {
+      "label": "Compact Mode (Token Efficient)",
+      "sensitive": false,
+      "advanced": true
+    }
+  }
+}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "psyche-ai",
+  "version": "2.0.0",
+  "description": "Artificial Psyche — universal emotional intelligence plugin for any AI agent",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./openclaw": {
+      "types": "./dist/adapters/openclaw.d.ts",
+      "default": "./dist/adapters/openclaw.js"
+    },
+    "./vercel-ai": {
+      "types": "./dist/adapters/vercel-ai.d.ts",
+      "default": "./dist/adapters/vercel-ai.js"
+    },
+    "./langchain": {
+      "types": "./dist/adapters/langchain.d.ts",
+      "default": "./dist/adapters/langchain.js"
+    },
+    "./http": {
+      "types": "./dist/adapters/http.d.ts",
+      "default": "./dist/adapters/http.js"
+    }
+  },
+  "bin": {
+    "psyche": "dist/cli.js",
+    "psyche-ai": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:test": "tsc -p tsconfig.test.json",
+    "test": "npm run build && npm run build:test && node --test dist-test/tests/*.test.js",
+    "typecheck": "tsc --noEmit --strict",
+    "dev": "tsc --watch"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Shangri-la-0428/psyche-ai.git"
+  },
+  "keywords": ["ai", "emotion", "personality", "mbti", "agent", "psyche", "openclaw", "vercel-ai", "langchain", "emotional-intelligence"],
+  "files": ["dist", "openclaw.plugin.json", "README.md", "LICENSE"],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.0",
+    "ai": ">=4.0.0",
+    "@langchain/core": ">=0.3.0"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    },
+    "ai": {
+      "optional": true
+    },
+    "@langchain/core": {
+      "optional": true
+    }
+  },
+  "openclaw": {
+    "extensions": ["./dist/adapters/openclaw.js"]
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}