psyche-ai 3.1.0 → 4.0.0

package/dist/prompt.js

@@ -15,7 +15,7 @@ import { getChannelProfile, buildChannelModifier } from "./channels.js";
  *
  * This is the "current moment" — what the agent is feeling RIGHT NOW.
  */
-export function buildDynamicContext(state, userId) {
+export function buildDynamicContext(state, userId, opts) {
     const { current, baseline, mbti, empathyLog, selfModel, meta, agreementStreak, emotionalHistory } = state;
     const locale = meta.locale ?? "zh";
     const relationship = getRelationship(state, userId);
@@ -88,6 +88,16 @@ export function buildDynamicContext(state, userId) {
     if (reciprocity) {
         parts.push("", reciprocity);
     }
+    // Metacognitive awareness (P5)
+    if (opts?.metacognitiveNote) {
+        const mcTitle = locale === "zh" ? "元认知" : "Metacognition";
+        parts.push("", `[${mcTitle}] ${opts.metacognitiveNote}`);
+    }
+    // Decision bias context (P5)
+    if (opts?.decisionContext) {
+        const dbTitle = locale === "zh" ? "决策倾向" : "Decision Bias";
+        parts.push("", `[${dbTitle}] ${opts.decisionContext}`);
+    }
     parts.push("", agencyReminder, sycophancyWarning, "", t("dynamic.update_reminder", locale));
     return parts.filter((l) => l !== undefined).join("\n");
 }
@@ -478,7 +488,19 @@ export function buildCompactContext(state, userId, opts) {
         if (selfCtx)
             parts.push(selfCtx);
     }
-    // 9. Cross-session emotional memory — surface relationship history
+    // 9. Metacognitive awareness (P5)
+    if (opts?.metacognitiveNote) {
+        parts.push(locale === "zh"
+            ? `[元认知] ${opts.metacognitiveNote}`
+            : `[Metacognition] ${opts.metacognitiveNote}`);
+    }
+    // 9b. Decision bias (P5) — only if significantly non-neutral
+    if (opts?.decisionContext) {
+        parts.push(locale === "zh"
+            ? `[决策倾向] ${opts.decisionContext}`
+            : `[Decision Bias] ${opts.decisionContext}`);
+    }
+    // 10. Cross-session emotional memory — surface relationship history
     const relationship = getRelationship(state, userId);
     if (relationship.memory && relationship.memory.length > 0) {
         const memLines = relationship.memory.slice(-3); // last 3 sessions
@@ -486,12 +508,12 @@ export function buildCompactContext(state, userId, opts) {
             ? `[记忆]\n${memLines.join("\n")}`
             : `[Memory]\n${memLines.join("\n")}`);
     }
-    // 10. Channel modifier — expression style per platform (between memory and empathy)
+    // 11. Channel modifier — expression style per platform (between memory and empathy)
     if (opts?.channelType) {
         const channelProfile = getChannelProfile(opts.channelType);
         parts.push(buildChannelModifier(channelProfile, locale));
     }
-    // 11. Empathy report — only when user shares feelings
+    // 12. 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.js

@@ -4,7 +4,7 @@
 // ============================================================
 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, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, MAX_EMOTIONAL_HISTORY, MAX_RELATIONSHIP_MEMORY, } from "./types.js";
+import { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, 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";
@@ -241,11 +241,13 @@ export function migrateToLatest(raw, fallbackName) {
     }
     // v2→v3: add drives
     // v3→v4: add learning
+    // v4→v5: add metacognition
     return {
         ...state,
-        version: 4,
+        version: 5,
         drives: state.drives ?? { ...DEFAULT_DRIVES },
         learning: state.learning ?? { ...DEFAULT_LEARNING_STATE },
+        metacognition: state.metacognition ?? { ...DEFAULT_METACOGNITIVE_STATE },
     };
 }
 /**
@@ -259,7 +261,7 @@ export async function initializeState(workspaceDir, opts, logger = NOOP_LOGGER)
     const selfModel = getDefaultSelfModel(mbti);
     const now = new Date().toISOString();
     const state = {
-        version: 4,
+        version: 5,
         mbti,
         baseline,
         current: { ...baseline },
@@ -274,6 +276,7 @@ export async function initializeState(workspaceDir, opts, logger = NOOP_LOGGER)
         agreementStreak: 0,
         lastDisagreement: null,
         learning: { ...DEFAULT_LEARNING_STATE },
+        metacognition: { ...DEFAULT_METACOGNITIVE_STATE },
         meta: {
             agentName,
             createdAt: now,

package/dist/types.d.ts

@@ -145,9 +145,39 @@ export declare const MAX_PREDICTION_HISTORY = 50;
 export declare const MAX_OUTCOME_HISTORY = 50;
 /** Max regret history entries */
 export declare const MAX_REGRET_HISTORY = 20;
-/** Persisted psyche state for an agent (v4: emotional learning) */
+/** Max metacognitive regulation history entries */
+export declare const MAX_REGULATION_HISTORY = 30;
+/** Max defense pattern entries */
+export declare const MAX_DEFENSE_PATTERNS = 10;
+/** Regulation strategy type */
+export type RegulationStrategyType = "reappraisal" | "strategic-expression" | "self-soothing";
+/** Defense mechanism type */
+export type DefenseMechanismType = "rationalization" | "projection" | "sublimation" | "avoidance";
+/** Record of a past regulation attempt */
+export interface RegulationRecord {
+    strategy: RegulationStrategyType;
+    timestamp: string;
+    effective: boolean;
+}
+/** Tracked defense pattern frequency */
+export interface DefensePatternRecord {
+    mechanism: DefenseMechanismType;
+    frequency: number;
+    lastSeen: string;
+}
+/** Persistent metacognitive state */
+export interface MetacognitiveState {
+    regulationHistory: RegulationRecord[];
+    defensePatterns: DefensePatternRecord[];
+    /** Running average of emotional confidence across assessments */
+    avgEmotionalConfidence: number;
+    totalAssessments: number;
+}
+/** Default empty metacognitive state */
+export declare const DEFAULT_METACOGNITIVE_STATE: MetacognitiveState;
+/** Persisted psyche state for an agent (v5: metacognition + decision modulation) */
 export interface PsycheState {
-    version: 3 | 4;
+    version: 3 | 4 | 5;
     mbti: MBTIType;
     baseline: ChemicalState;
     current: ChemicalState;
@@ -160,6 +190,7 @@ export interface PsycheState {
     agreementStreak: number;
     lastDisagreement: string | null;
     learning: LearningState;
+    metacognition: MetacognitiveState;
     meta: {
         agentName: string;
         createdAt: string;

package/dist/types.js

@@ -85,6 +85,17 @@ export const MAX_PREDICTION_HISTORY = 50;
 export const MAX_OUTCOME_HISTORY = 50;
 /** Max regret history entries */
 export const MAX_REGRET_HISTORY = 20;
+/** Max metacognitive regulation history entries */
+export const MAX_REGULATION_HISTORY = 30;
+/** Max defense pattern entries */
+export const MAX_DEFENSE_PATTERNS = 10;
+/** Default empty metacognitive state */
+export const DEFAULT_METACOGNITIVE_STATE = {
+    regulationHistory: [],
+    defensePatterns: [],
+    avgEmotionalConfidence: 0.5,
+    totalAssessments: 0,
+};
 /** 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 = "3.1.0";
+const CURRENT_VERSION = "4.0.0";
 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": "3.1.0",
+  "version": "4.0.0",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

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