psyche-ai 4.0.0 → 5.1.0

package/dist/generative-self.d.ts

@@ -0,0 +1,88 @@
+import type { PsycheState, ChemicalState, StimulusType, DriveType, Locale } from "./types.js";
+/** A causal link between experience and personality trait */
+export interface CausalInsight {
+    /** The observed trait, e.g. "I'm cautious with new people" */
+    trait: string;
+    /** The causal reason, e.g. "Early interactions involved criticism" */
+    because: string;
+    /** Supporting evidence from chemical/learning data */
+    evidence: string;
+    /** Confidence in this insight, 0-1 */
+    confidence: number;
+}
+/** A predicted emotional reaction to a hypothetical stimulus */
+export interface SelfPrediction {
+    /** The hypothetical stimulus */
+    stimulus: StimulusType;
+    /** Predicted chemical deltas */
+    predictedChemistry: ChemicalState;
+    /** Predicted dominant emotion label */
+    predictedEmotion: string;
+    /** How confident the prediction is, 0-1 */
+    confidence: number;
+}
+/** Tracks how personality has evolved over time */
+export interface GrowthArc {
+    /** Overall direction of personality evolution */
+    direction: "growing" | "stable" | "regressing" | "transforming";
+    /** Human-readable description of the growth trajectory */
+    description: string;
+    /** Per-chemical trend over recent history */
+    chemicalTrend: Partial<Record<keyof ChemicalState, "rising" | "falling" | "stable">>;
+    /** Per-drive satisfaction trend */
+    driveTrend: Partial<Record<DriveType, "more-satisfied" | "less-satisfied" | "stable">>;
+}
+/** An internal conflict between subsystems */
+export interface InternalConflict {
+    /** Which subsystems are in tension */
+    subsystems: [string, string];
+    /** Human-readable description of the conflict */
+    description: string;
+    /** Severity from 0 (minor tension) to 1 (acute conflict) */
+    severity: number;
+}
+/** The complete generative self-model */
+export interface GenerativeSelfModel {
+    /** Core identity narrative: who am I and why? */
+    identityNarrative: string;
+    /** Causal chains: experience -> personality trait */
+    causalInsights: CausalInsight[];
+    /** Predicted emotional reactions to hypothetical stimuli */
+    predictions: SelfPrediction[];
+    /** Growth trajectory: how has the self changed? */
+    growthArc: GrowthArc;
+    /** Internal conflicts: where do my subsystems disagree? */
+    conflicts: InternalConflict[];
+}
+/**
+ * Compute the generative self-model from the full psyche state.
+ *
+ * Analyzes emotional history for patterns, extracts causal insights
+ * from learning data, builds an identity narrative, predicts reactions,
+ * and surfaces internal conflicts.
+ */
+export declare function computeGenerativeSelf(state: PsycheState): GenerativeSelfModel;
+/**
+ * Predict own emotional reaction to a hypothetical stimulus.
+ *
+ * Uses learned vectors if available for context, otherwise falls back
+ * to the baseline MBTI profile vectors. Returns predicted chemistry,
+ * dominant emotion label, and confidence.
+ */
+export declare function predictSelfReaction(state: PsycheState, stimulus: StimulusType, locale?: Locale): SelfPrediction;
+/**
+ * Detect conflicts between subsystems of the psyche.
+ *
+ * Examines drive levels, chemical state, attachment data, and
+ * self-model for contradictions that create internal tension.
+ */
+export declare function detectInternalConflicts(state: PsycheState, locale?: Locale): InternalConflict[];
+/**
+ * Generate a 2-3 sentence identity statement from the psyche state.
+ *
+ * Feels genuine, not clinical:
+ * "I'm someone who gets excited by ideas but needs time to process emotions.
+ * I've learned to be more cautious with criticism because it hits harder
+ * than I expect."
+ */
+export declare function buildIdentityNarrative(state: PsycheState, insights: CausalInsight[], growthArc: GrowthArc, locale?: Locale): string;