psyche-ai 3.1.0 → 5.0.0

package/dist/index.js

@@ -12,7 +12,7 @@
 export { PsycheEngine } from "./core.js";
 // Storage
 export { FileStorageAdapter, MemoryStorageAdapter } from "./storage.js";
-export { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_ATTACHMENT, DRIVE_KEYS, DRIVE_NAMES_ZH, } from "./types.js";
+export { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, DEFAULT_PERSONHOOD_STATE, DEFAULT_ATTACHMENT, DRIVE_KEYS, DRIVE_NAMES_ZH, } from "./types.js";
 // Self-recognition
 export { computeSelfReflection, computeEmotionalTendency, buildSelfReflectionContext } from "./self-recognition.js";
 // Multi-agent interaction
@@ -29,6 +29,18 @@ export { classifyStimulusWithContext, extractContextFeatures, stimulusWarmth } f
 export { predictNextStimulus, generateAnticipation, computeSurpriseEffect, computeRegret, } from "./temporal.js";
 // Attachment dynamics (P4)
 export { updateAttachment, computeSeparationEffect, computeReunionEffect, } from "./attachment.js";
+// Metacognition (P5)
+export { assessMetacognition, computeEmotionalConfidence, generateRegulationSuggestions, detectDefenseMechanisms, } from "./metacognition.js";
+// Decision bias (P5)
+export { computeDecisionBias, computeAttentionWeights, computeExploreExploit, buildDecisionContext, } from "./decision-bias.js";
+// Experiential field (P6)
+export { computeExperientialField, computeCoherence, detectUnnamedEmotion } from "./experiential-field.js";
+// Generative self (P6)
+export { computeGenerativeSelf, predictSelfReaction, detectInternalConflicts, buildIdentityNarrative } from "./generative-self.js";
+// Shared intentionality (P6)
+export { updateSharedIntentionality, estimateOtherMood, buildSharedIntentionalityContext } from "./shared-intentionality.js";
+// Emotional ethics (P6)
+export { assessEthics, detectIntermittentReinforcement, detectDependencyRisk, buildEthicalContext, } from "./ethics.js";
 // Utilities — for custom adapter / advanced use
 export { classifyStimulus, getPrimaryStimulus } from "./classify.js";
 export { buildProtocolContext, buildDynamicContext, buildCompactContext, isNearBaseline } from "./prompt.js";

package/dist/metacognition.d.ts

@@ -0,0 +1,60 @@
+import type { PsycheState, StimulusType, ChemicalState, OutcomeScore, MetacognitiveState, RegulationStrategyType, DefenseMechanismType } from "./types.js";
+export interface MetacognitiveAssessment {
+    /** 0-1: how reliably has this emotional state led to good outcomes in similar contexts */
+    emotionalConfidence: number;
+    /** Suggested regulation strategies */
+    regulationSuggestions: RegulationSuggestion[];
+    /** Detected psychological defense mechanisms */
+    defenseMechanisms: DetectedDefense[];
+    /** Human-readable self-awareness note for prompt injection */
+    metacognitiveNote: string;
+}
+export interface RegulationSuggestion {
+    strategy: RegulationStrategyType;
+    description: string;
+    /** Suggested micro-adjustment to chemistry */
+    chemistryAdjustment?: Partial<ChemicalState>;
+    /** 0-1: confidence that this strategy would help */
+    confidence: number;
+}
+export interface DetectedDefense {
+    mechanism: DefenseMechanismType;
+    evidence: string;
+    /** 0-1: how strongly the pattern is expressed */
+    strength: number;
+}
+/**
+ * Assess the current metacognitive state.
+ *
+ * Evaluates emotional reliability, generates regulation suggestions,
+ * and detects defense mechanism patterns. Designed to run after emotion
+ * detection and before prompt construction.
+ */
+export declare function assessMetacognition(state: PsycheState, currentStimulus: StimulusType, recentOutcomes: OutcomeScore[]): MetacognitiveAssessment;
+/**
+ * Compute confidence in the current emotional state's reliability.
+ *
+ * "How often has being in this kind of emotional state, in response to
+ * this kind of stimulus, led to good outcomes?"
+ *
+ * Uses outcome history filtered by similar stimulus and similar chemistry profile.
+ */
+export declare function computeEmotionalConfidence(state: PsycheState, currentStimulus: StimulusType, recentOutcomes: OutcomeScore[]): number;
+/**
+ * Generate regulation suggestions based on current state and confidence.
+ */
+export declare function generateRegulationSuggestions(state: PsycheState, currentStimulus: StimulusType, emotionalConfidence: number, recentOutcomes: OutcomeScore[]): RegulationSuggestion[];
+/**
+ * Detect patterns matching known psychological defense mechanisms.
+ *
+ * These are not suppressed — they are surfaced for self-awareness.
+ * The agent can then acknowledge the pattern in its prompt context.
+ */
+export declare function detectDefenseMechanisms(state: PsycheState, currentStimulus: StimulusType, recentOutcomes: OutcomeScore[]): DetectedDefense[];
+/**
+ * Update the persistent metacognitive state after an assessment.
+ *
+ * Tracks regulation history, defense pattern frequencies, and running
+ * confidence average. Called after assessMetacognition to persist learnings.
+ */
+export declare function updateMetacognitiveState(metacognition: MetacognitiveState, assessment: MetacognitiveAssessment): MetacognitiveState;