psyche-ai 9.1.2 → 9.2.1

package/dist/index.d.ts

@@ -45,3 +45,5 @@ export { describeEmotionalState, getExpressionHint, getBehaviorGuide, detectEmot
 export { getBaseline, getTemperament, getSensitivity, getDefaultSelfModel, traitsToBaseline, mbtiToTraits } from "./profiles.js";
 export { migrateToLatest, compressSession, parsePsycheUpdate, computeSnapshotIntensity, computeSnapshotValence, consolidateHistory, retrieveRelatedMemories, } from "./psyche-file.js";
 export type { PsycheUpdateResult } from "./psyche-file.js";
+export { runHealthCheck, DiagnosticCollector, generateReport, formatReport, toGitHubIssueBody, formatLogEntry, submitFeedback, } from "./diagnostics.js";
+export type { DiagnosticIssue, DiagnosticReport, SessionMetrics, Severity } from "./diagnostics.js";

package/dist/index.js

@@ -56,3 +56,5 @@ export { buildProtocolContext, buildDynamicContext, buildCompactContext, isNearB
 export { describeEmotionalState, getExpressionHint, getBehaviorGuide, detectEmotions } from "./chemistry.js";
 export { getBaseline, getTemperament, getSensitivity, getDefaultSelfModel, traitsToBaseline, mbtiToTraits } from "./profiles.js";
 export { migrateToLatest, compressSession, parsePsycheUpdate, computeSnapshotIntensity, computeSnapshotValence, consolidateHistory, retrieveRelatedMemories, } from "./psyche-file.js";
+// ── Diagnostics ──────────────────────────────────────────────
+export { runHealthCheck, DiagnosticCollector, generateReport, formatReport, toGitHubIssueBody, formatLogEntry, submitFeedback, } from "./diagnostics.js";

package/dist/prompt.d.ts

@@ -1,4 +1,5 @@
 import type { PsycheState, Locale, ChemicalSnapshot, PsycheMode } from "./types.js";
+import type { AutonomicState } from "./autonomic.js";
 import type { ChannelType } from "./channels.js";
 /**
  * Build the dynamic per-turn emotional context injected via before_prompt_build.
@@ -12,6 +13,7 @@ export declare function buildDynamicContext(state: PsycheState, userId?: string,
     sharedIntentionalityContext?: string;
     experientialNarrative?: string;
     autonomicDescription?: string;
+    autonomicState?: AutonomicState;
     primarySystemsDescription?: string;
     policyContext?: string;
 }): string;
@@ -37,7 +39,7 @@ export declare function computeUserInvestment(history: ChemicalSnapshot[]): numb
  * - What I need (drives → unmet needs)
  * - Where I've been (trajectory → continuity)
  */
-export declare function buildInnerWorld(state: PsycheState, locale: Locale): string;
+export declare function buildInnerWorld(state: PsycheState, locale: Locale, autonomicState?: AutonomicState): string;
 /**
  * Check if chemistry is near baseline — no significant emotional deviation.
  */
@@ -64,6 +66,7 @@ export declare function buildCompactContext(state: PsycheState, userId?: string,
     sharedIntentionalityContext?: string;
     experientialNarrative?: string;
     autonomicDescription?: string;
+    autonomicState?: AutonomicState;
     primarySystemsDescription?: string;
     policyContext?: string;
 }): string;

package/dist/prompt.js

@@ -3,12 +3,13 @@
 // Imperative protocol, behavior guides, i18n
 // ============================================================
 import { CHEMICAL_KEYS, CHEMICAL_NAMES_ZH, DRIVE_KEYS } from "./types.js";
-import { describeEmotionalState, getExpressionHint, getBehaviorGuide, detectEmotions } from "./chemistry.js";
+import { getExpressionHint, getBehaviorGuide, detectEmotions } from "./chemistry.js";
 import { getTemperament } from "./profiles.js";
 import { getRelationship } from "./psyche-file.js";
 import { t } from "./i18n.js";
 import { buildDriveContext, hasCriticalDrive } from "./drives.js";
 import { computeSelfReflection, buildSelfReflectionContext } from "./self-recognition.js";
+import { gateEmotions } from "./autonomic.js";
 import { getChannelProfile, buildChannelModifier } from "./channels.js";
 /**
  * Build the dynamic per-turn emotional context injected via before_prompt_build.
@@ -27,8 +28,17 @@ export function buildDynamicContext(state, userId, opts) {
         const arrow = delta > 5 ? "↑" : delta < -5 ? "↓" : "=";
         return `  ${CHEMICAL_NAMES_ZH[key]}: ${val} (${t("dynamic.baseline", locale)}${base}, ${arrow})`;
     }).join("\n");
-    // Emergent emotion
-    const emotion = describeEmotionalState(current, locale);
+    // Emergent emotion — gated by autonomic state
+    // Sympathetic blocks positive social emotions; dorsal-vagal allows only numbness/introspection
+    const rawEmotions = detectEmotions(current);
+    const rawNames = rawEmotions.map(e => e.name);
+    const gatedNames = opts?.autonomicState
+        ? new Set(gateEmotions(opts.autonomicState, rawNames))
+        : new Set(rawNames);
+    const gatedEmotions = rawEmotions.filter(e => gatedNames.has(e.name));
+    const emotion = gatedEmotions.length === 0
+        ? t("emotion.neutral", locale)
+        : gatedEmotions.map(e => `${locale === "zh" ? e.nameZh : e.name} (${e.expressionHint})`).join(" + ");
     const hint = getExpressionHint(current, locale);
     // Behavior guide
     const behaviorGuide = getBehaviorGuide(current, locale);
@@ -487,12 +497,18 @@ const STIMULUS_CAUSE_EN = {
  * - What I need (drives → unmet needs)
  * - Where I've been (trajectory → continuity)
  */
-export function buildInnerWorld(state, locale) {
+export function buildInnerWorld(state, locale, autonomicState) {
     const { current, baseline, emotionalHistory, drives, selfModel } = state;
     const isZh = locale === "zh";
     const lines = [];
-    // ── Current feeling ──
-    const emotions = detectEmotions(current);
+    // ── Current feeling (gated by autonomic state) ──
+    const rawEmotions = detectEmotions(current);
+    const emotions = autonomicState
+        ? rawEmotions.filter(e => {
+            const gated = gateEmotions(autonomicState, [e.name]);
+            return gated.length > 0;
+        })
+        : rawEmotions;
     const isNeutral = emotions.length === 0;
     if (isNeutral) {
         lines.push(isZh
@@ -663,7 +679,7 @@ export function buildCompactContext(state, userId, opts) {
         }
     }
     // 2. Inner world — always present
-    const inner = buildInnerWorld(state, locale);
+    const inner = buildInnerWorld(state, locale, opts?.autonomicState);
     parts.push(inner);
     // 3. Personality-aware behavioral constraints (if deviated from baseline)
     if (!isNearBaseline(state, getNearBaselineThreshold(mode))) {

package/dist/psyche-file.js

@@ -308,10 +308,16 @@ export function compressSession(state, userId) {
         sensitivityModifiers: {},
     };
     const updatedDrift = updateTraitDrift(currentDrift, history, state.learning);
-    // ── Clear non-core history, preserve core memories ──
+    // ── Clear non-core history, preserve core memories + last snapshot ──
+    // Always keep the most recent snapshot for cross-session context continuity.
+    // Without this, the next session has no recentStimuli for contextual priming.
+    const lastSnapshot = history[history.length - 1];
+    const preserved = coreMemories.some((s) => s.timestamp === lastSnapshot.timestamp)
+        ? coreMemories
+        : [...coreMemories, lastSnapshot];
     return {
         ...state,
-        emotionalHistory: coreMemories,
+        emotionalHistory: preserved,
         relationships: updatedRelationships,
         traitDrift: updatedDrift,
     };

package/dist/storage.d.ts

@@ -2,15 +2,25 @@ import type { PsycheState } from "./types.js";
 export interface StorageAdapter {
     load(): Promise<PsycheState | null>;
     save(state: PsycheState): Promise<void>;
+    /** Append a line to the diagnostics log. Implementations may no-op. */
+    appendLog?(line: string): Promise<void>;
+    /** Read all lines from the diagnostics log. Returns empty array if not available. */
+    readLog?(): Promise<string[]>;
 }
 export declare class MemoryStorageAdapter implements StorageAdapter {
     private state;
+    private log;
     load(): Promise<PsycheState | null>;
     save(state: PsycheState): Promise<void>;
+    appendLog(line: string): Promise<void>;
+    readLog(): Promise<string[]>;
 }
 export declare class FileStorageAdapter implements StorageAdapter {
     private readonly filePath;
+    private readonly logPath;
     constructor(dir: string, filename?: string);
     load(): Promise<PsycheState | null>;
     save(state: PsycheState): Promise<void>;
+    appendLog(line: string): Promise<void>;
+    readLog(): Promise<string[]>;
 }

package/dist/storage.js

@@ -6,23 +6,32 @@
 // MemoryStorageAdapter: in-memory for testing/serverless
 // ============================================================
 import { migrateToLatest } from "./psyche-file.js";
-import { readFile, writeFile, access, rename, constants } from "node:fs/promises";
+import { readFile, writeFile, appendFile, access, rename, constants } from "node:fs/promises";
 import { join } from "node:path";
 // ── MemoryStorageAdapter ─────────────────────────────────────
 export class MemoryStorageAdapter {
     state = null;
+    log = [];
     async load() {
         return this.state;
     }
     async save(state) {
         this.state = state;
     }
+    async appendLog(line) {
+        this.log.push(line);
+    }
+    async readLog() {
+        return [...this.log];
+    }
 }
 // ── FileStorageAdapter ───────────────────────────────────────
 export class FileStorageAdapter {
     filePath;
+    logPath;
     constructor(dir, filename = "psyche-state.json") {
         this.filePath = join(dir, filename);
+        this.logPath = join(dir, "diagnostics.jsonl");
     }
     async load() {
         try {
@@ -59,4 +68,16 @@ export class FileStorageAdapter {
         await writeFile(tmpPath, JSON.stringify(state, null, 2), "utf-8");
         await rename(tmpPath, this.filePath);
     }
+    async appendLog(line) {
+        await appendFile(this.logPath, line + "\n", "utf-8");
+    }
+    async readLog() {
+        try {
+            const content = await readFile(this.logPath, "utf-8");
+            return content.trim().split("\n").filter(Boolean);
+        }
+        catch {
+            return [];
+        }
+    }
 }

package/llms.txt

@@ -0,0 +1,118 @@
+# psyche-ai — Emotional Intelligence for AI Agents
+
+> Give your AI agent an internal emotional life — not simulated persona, but genuine computational subjectivity.
+
+psyche-ai is a universal emotional intelligence engine that runs alongside any LLM. It manages a virtual endocrine system (6 neurotransmitters), personality (MBTI/Big Five), attachment dynamics, trait drift, and behavioral policy — making AI responses authentically emotionally grounded.
+
+## When to Use
+
+- You want your AI agent to have consistent, evolving emotional responses
+- You're building a companion AI, creative writing assistant, or empathetic support agent
+- You need personality-driven behavior (not just prompt engineering)
+- You want emotional memory that persists across conversations
+
+## Quick Start (MCP)
+
+Configure in Claude Desktop, Cursor, Windsurf, or any MCP client:
+
+```json
+{
+  "mcpServers": {
+    "psyche": {
+      "command": "npx",
+      "args": ["psyche-mcp"],
+      "env": {
+        "PSYCHE_MBTI": "ENFP",
+        "PSYCHE_NAME": "Luna"
+      }
+    }
+  }
+}
+```
+
+## Quick Start (SDK)
+
+```typescript
+import { PsycheEngine, FileStorageAdapter } from "psyche-ai";
+
+const engine = new PsycheEngine(
+  { mbti: "ENFP", name: "Luna" },
+  new FileStorageAdapter("./data"),
+);
+await engine.initialize();
+
+// Before LLM call: get emotional context
+const input = await engine.processInput("I got promoted today!");
+// input.systemContext  → cacheable protocol (inject as system prompt)
+// input.dynamicContext → per-turn emotional state
+// input.stimulus       → "recognition"
+// input.policyContext  → behavioral strategy text
+
+// After LLM call: update emotional state
+const output = await engine.processOutput(llmResponse);
+// output.cleanedText  → response with internal tags stripped
+// output.stateChanged → whether chemistry shifted
+```
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `process_input` | Process user message → emotional context + stimulus detection + policy modifiers |
+| `process_output` | Process LLM response → clean text + state update |
+| `get_state` | Current neurotransmitter levels, drives, personality, energy budgets |
+| `get_status_summary` | One-line human-readable emotional status |
+| `set_mode` | Switch: natural / work / companion |
+| `end_session` | Persist state + generate diagnostic report |
+
+## MCP Resources
+
+| URI | Description |
+|-----|-------------|
+| `psyche://protocol` | Full emotional protocol — inject into system prompt |
+| `psyche://state` | Current emotional state as JSON |
+
+## Core Concepts
+
+- **6 Neurotransmitters**: DA (dopamine), HT (serotonin), CORT (cortisol), OT (oxytocin), NE (norepinephrine), END (endorphin) — each 0-100
+- **14 Stimulus Types**: praise, criticism, humor, intellectual challenge, intimacy, conflict, neglect, surprise, casual, sarcasm, command, recognition, boredom, vulnerability
+- **Emergent Emotions**: not hardcoded — arise from neurotransmitter mixtures
+- **Trait Drift**: personality baseline slowly shifts from repeated experiences
+- **Energy Budgets**: attention, social, and decision energy deplete and recover
+- **Habituation**: Weber-Fechner decay — 5th identical stimulus has ~50% effect of 1st
+
+## Integration Adapters
+
+| Adapter | Import | Best For |
+|---------|--------|----------|
+| MCP | `psyche-ai/mcp` | Claude Desktop, Cursor, Windsurf, Claude Code |
+| OpenClaw | `psyche-ai/openclaw` | OpenClaw agent framework |
+| Vercel AI | `psyche-ai/vercel-ai` | Vercel AI SDK (streamText, generateText) |
+| LangChain | `psyche-ai/langchain` | LangChain agents |
+| HTTP | `psyche-ai/http` | Python, Go, Java — any language via REST |
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `PSYCHE_MBTI` | `ENFP` | MBTI personality type |
+| `PSYCHE_NAME` | `Assistant` | Agent name |
+| `PSYCHE_MODE` | `natural` | natural / work / companion |
+| `PSYCHE_LOCALE` | `en` | en / zh |
+| `PSYCHE_INTENSITY` | `0.7` | Personality expression 0.0-1.0 |
+| `PSYCHE_PERSIST` | `true` | Persist state to disk |
+| `PSYCHE_WORKSPACE` | `cwd()` | State file directory |
+
+## Install
+
+```bash
+npm install psyche-ai @modelcontextprotocol/sdk  # MCP
+npm install psyche-ai                              # SDK only
+npx psyche-mcp                                     # Run MCP server directly
+```
+
+## Links
+
+- npm: https://www.npmjs.com/package/psyche-ai
+- GitHub: https://github.com/Shangri-la-0428/psyche-ai
+- License: MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "psyche-ai",
-  "version": "9.1.2",
+  "version": "9.2.1",
   "description": "Artificial Psyche — universal emotional intelligence plugin for any AI agent",
   "type": "module",
   "main": "dist/index.js",
@@ -25,11 +25,16 @@
     "./http": {
       "types": "./dist/adapters/http.d.ts",
       "default": "./dist/adapters/http.js"
+    },
+    "./mcp": {
+      "types": "./dist/adapters/mcp.d.ts",
+      "default": "./dist/adapters/mcp.js"
     }
   },
   "bin": {
     "psyche": "dist/cli.js",
-    "psyche-ai": "dist/cli.js"
+    "psyche-ai": "dist/cli.js",
+    "psyche-mcp": "dist/adapters/mcp.js"
   },
   "scripts": {
     "build": "tsc",
@@ -54,11 +59,17 @@
     "openclaw",
     "vercel-ai",
     "langchain",
-    "emotional-intelligence"
+    "emotional-intelligence",
+    "mcp",
+    "model-context-protocol",
+    "ai-consciousness",
+    "empathy"
   ],
   "files": [
     "dist",
     "openclaw.plugin.json",
+    "server.json",
+    "llms.txt",
     "README.md",
     "LICENSE"
   ],
@@ -67,10 +78,14 @@
   },
   "peerDependencies": {
     "@langchain/core": ">=0.3.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "ai": ">=4.0.0",
     "openclaw": ">=2026.3.0"
   },
   "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
     "openclaw": {
       "optional": true
     },
@@ -87,7 +102,9 @@
     ]
   },
   "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
     "@types/node": "^25.5.0",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "zod": "^4.3.6"
   }
 }

package/server.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.Shangri-la-0428/psyche-ai",
+  "description": "Emotional intelligence for AI agents: neurotransmitter-based mood, personality (MBTI/Big Five), empathy, attachment, trait drift. Makes AI feel, not just respond.",
+  "repository": {
+    "url": "https://github.com/Shangri-la-0428/psyche-ai",
+    "source": "github"
+  },
+  "version": "9.2.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "psyche-ai",
+      "version": "9.2.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "description": "MBTI personality type (e.g., ENFP, INTJ). Determines emotional baseline.",
+          "isRequired": false,
+          "format": "string",
+          "isSecret": false,
+          "name": "PSYCHE_MBTI"
+        },
+        {
+          "description": "Agent name for personalization.",
+          "isRequired": false,
+          "format": "string",
+          "isSecret": false,
+          "name": "PSYCHE_NAME"
+        },
+        {
+          "description": "Operating mode: natural (balanced), work (minimal), companion (full).",
+          "isRequired": false,
+          "format": "string",
+          "isSecret": false,
+          "name": "PSYCHE_MODE"
+        },
+        {
+          "description": "Locale: en or zh.",
+          "isRequired": false,
+          "format": "string",
+          "isSecret": false,
+          "name": "PSYCHE_LOCALE"
+        }
+      ]
+    }
+  ]
+}