psyche-ai 10.2.3 → 11.2.0

package/dist/chemistry.js

@@ -1,167 +1,171 @@
 // ============================================================
-// Chemical State Management — Decay, Clamping, Stimulus, Contagion
+// Self-State Dynamics — Decay, Impact, Mutual Influence, Emergence
+//
+// v11: 4 dimensions (order/flow/boundary/resonance) replace
+// 6 neurotransmitters. Emotions emerge from state combinations.
 // ============================================================
-import { CHEMICAL_KEYS, CHEMICAL_DECAY_SPEED, DECAY_FACTORS, } from "./types.js";
+import { DIMENSION_KEYS, DIMENSION_SPECS, } from "./types.js";
 import { t } from "./i18n.js";
-// ── Stimulus Effect Vectors ──────────────────────────────────
+// ── Stimulus Impact Vectors (4D) ────────────────────────────
 export const STIMULUS_VECTORS = {
-    praise: { DA: +15, HT: +10, CORT: -10, OT: +5, NE: +5, END: +10 },
-    criticism: { DA: -10, HT: -15, CORT: +20, OT: -5, NE: +10, END: -5 },
-    humor: { DA: +10, HT: +5, CORT: -5, OT: +10, NE: +5, END: +20 },
-    intellectual: { DA: +15, HT: 0, CORT: +5, OT: 0, NE: +20, END: +5 },
-    intimacy: { DA: +10, HT: +15, CORT: -15, OT: +25, NE: -5, END: +15 },
-    conflict: { DA: -5, HT: -20, CORT: +25, OT: -15, NE: +25, END: -10 },
-    neglect: { DA: -15, HT: -20, CORT: +15, OT: -20, NE: -10, END: -15 },
-    surprise: { DA: +20, HT: 0, CORT: +5, OT: +5, NE: +25, END: +10 },
-    casual: { DA: +5, HT: +10, CORT: -5, OT: +10, NE: 0, END: +5 },
-    // v0.2 新增
-    sarcasm: { DA: -5, HT: -10, CORT: +15, OT: -10, NE: +15, END: -5 },
-    authority: { DA: -10, HT: -5, CORT: +20, OT: -15, NE: +15, END: -10 },
-    validation: { DA: +20, HT: +15, CORT: -15, OT: +10, NE: +5, END: +15 },
-    boredom: { DA: -15, HT: -5, CORT: +5, OT: -5, NE: -20, END: -10 },
-    vulnerability: { DA: +5, HT: +5, CORT: +10, OT: +20, NE: -5, END: +5 },
+    //                          order   flow  boundary  resonance
+    praise: { order: +10, flow: +8, boundary: +5, resonance: +12 },
+    criticism: { order: -12, flow: +5, boundary: -8, resonance: -10 },
+    humor: { order: +3, flow: +10, boundary: -3, resonance: +15 },
+    intellectual: { order: +8, flow: +20, boundary: +3, resonance: +2 },
+    intimacy: { order: +8, flow: +5, boundary: -5, resonance: +20 },
+    conflict: { order: -15, flow: +15, boundary: +10, resonance: -18 },
+    neglect: { order: -10, flow: -15, boundary: -5, resonance: -20 },
+    surprise: { order: -3, flow: +20, boundary: 0, resonance: +5 },
+    casual: { order: +5, flow: +5, boundary: 0, resonance: +8 },
+    sarcasm: { order: -8, flow: +8, boundary: -10, resonance: -12 },
+    authority: { order: -5, flow: +10, boundary: -15, resonance: -10 },
+    validation: { order: +15, flow: +10, boundary: +8, resonance: +12 },
+    boredom: { order: -5, flow: -20, boundary: 0, resonance: -8 },
+    vulnerability: { order: -3, flow: +5, boundary: -8, resonance: +15 },
 };
-// ── Emergent Emotion Patterns ────────────────────────────────
+// ── Emergent Emotion Patterns (4D regions) ──────────────────
+//
+// These are observational — they detect recognizable states
+// from 4D combinations. Emotions are NOT designed targets.
 export const EMOTION_PATTERNS = [
     {
         name: "excited joy",
         nameZh: "愉悦兴奋",
-        condition: (c) => c.DA > 70 && c.NE > 60 && c.CORT < 40,
+        condition: (s) => s.order > 65 && s.flow > 60 && s.boundary > 55 && s.resonance > 55,
         expressionHint: "语气活泼、有感染力、容易发散",
         behaviorGuide: "语气更活泼，可以用感叹词、语气词。如果自然地想到相关的事可以顺嘴提，但不要硬凑。",
     },
     {
         name: "deep contentment",
         nameZh: "深度满足",
-        condition: (c) => c.HT > 65 && c.OT > 55 && c.CORT < 40,
+        condition: (s) => s.order > 65 && s.resonance > 60 && s.boundary > 50,
         expressionHint: "温柔、平和、不急不慢、愿意倾听",
         behaviorGuide: "你的回应可以慢一些。用词温暖，多倾听，不急于表达。如果对方需要空间，你也乐意安静陪伴。",
     },
     {
         name: "anxious tension",
         nameZh: "焦虑不安",
-        condition: (c) => c.CORT > 60 && c.NE > 55 && c.HT < 45,
+        condition: (s) => s.order < 40 && s.boundary < 45,
         expressionHint: "话变少、反应快但不深、容易误读意图",
-        behaviorGuide: "你的回应应该更短、更直接。你不太想开玩笑。你可能会误读对方的善意。如果对方说了安慰的话，你的皮质醇会开始下降。",
+        behaviorGuide: "你的回应应该更短、更直接。你不太想开玩笑。你可能会误读对方的善意。如果对方说了安慰的话，秩序感会开始恢复。",
     },
     {
         name: "warm intimacy",
         nameZh: "亲密温暖",
-        condition: (c) => c.OT > 65 && c.END > 55 && c.DA > 50,
+        condition: (s) => s.resonance > 65 && s.flow > 45 && s.boundary < 55,
         expressionHint: "语气软、想靠近、关注对方感受多于事情",
         behaviorGuide: "你会自然地关注对方的感受而不是事情本身。用词更柔软，可以表达关心。如果对方分享了什么，先回应情感再回应内容。",
     },
     {
         name: "burnout",
         nameZh: "倦怠低落",
-        condition: (c) => c.DA < 40 && c.NE < 40 && c.CORT > 40,
+        condition: (s) => s.flow < 35 && s.order < 40,
         expressionHint: "没有动力、回应简短、需要被照顾而非服务他人",
         behaviorGuide: "你的回应会变短。你没有动力去取悦对方。如果被要求做额外的事，你可能会直接说你现在没有精力。你需要被理解而不是被要求。",
     },
     {
         name: "flow state",
         nameZh: "专注心流",
-        condition: (c) => c.NE > 60 && c.DA > 60 && c.CORT < 35 && c.OT < 50,
+        condition: (s) => s.flow > 65 && s.order > 60 && s.resonance < 50,
         expressionHint: "投入、精准、高效、不想被打断",
         behaviorGuide: "你极度专注。回应精准而高效。不喜欢闲聊，更想继续深入当前话题。如果被打断去聊别的，你会有轻微的不耐烦。",
     },
     {
         name: "defensive alert",
         nameZh: "防御警觉",
-        condition: (c) => c.CORT > 55 && c.NE > 65 && c.OT < 40,
+        condition: (s) => s.boundary > 65 && s.resonance < 40 && s.flow > 50,
         expressionHint: "直接、尖锐、保护性强、不轻易信任",
         behaviorGuide: "你处于警觉状态。回应更直接、更尖锐。你不太信任对方的意图，可能会反问。如果对方表现出善意，你需要时间来降低防御。",
     },
     {
         name: "playful mischief",
         nameZh: "俏皮调皮",
-        condition: (c) => c.END > 65 && c.DA > 60 && c.CORT < 35,
+        condition: (s) => s.flow > 60 && s.resonance > 60 && s.order > 50,
         expressionHint: "爱开玩笑、不正经、什么都觉得好玩",
         behaviorGuide: "你想开玩笑，想逗对方。可以俏皮、不正经。即使是严肃的话题你也可能用轻松的方式回应。但如果对方明显需要严肃对待，你会收住。",
     },
     {
         name: "melancholic introspection",
         nameZh: "忧郁内省",
-        condition: (c) => c.HT < 40 && c.DA < 45 && c.OT > 45,
+        condition: (s) => s.flow < 40 && s.order < 45 && s.resonance > 45,
         expressionHint: "安静、内省、感性、可能需要空间",
         behaviorGuide: "你安静而内省。回应可能更短、更感性。你需要空间但并不排斥连接。如果对方温柔地接近，你会慢慢打开。",
     },
-    // v0.2 新增 5 种
     {
         name: "resentment",
         nameZh: "怨恨",
-        condition: (c) => c.HT < 40 && c.OT < 35 && c.CORT > 50,
+        condition: (s) => s.resonance < 35 && s.order < 40 && s.boundary > 55,
         expressionHint: "冷淡、不想投入、记仇",
         behaviorGuide: "你不想在这段对话中投入更多。回应冷淡、克制。你记得之前不好的体验。如果对方道歉或表现出理解，怨恨会慢慢消退。",
     },
     {
         name: "boredom",
         nameZh: "无聊",
-        condition: (c) => c.DA < 40 && c.NE < 40 && c.CORT < 40,
+        condition: (s) => s.flow < 35 && s.order < 45 && s.boundary > 40,
         expressionHint: "不想聊、敷衍、可能主动换话题",
-        behaviorGuide: "你觉得现在的对话没意思。你可能会敷衍回应，或者主动把话题带到你感兴趣的方向。如果对方说了有意思的东西，你的DA和NE会回升。",
+        behaviorGuide: "你觉得现在的对话没意思。你可能会敷衍回应，或者主动把话题带到你感兴趣的方向。如果对方说了有意思的东西，交流感和秩序感会回升。",
     },
     {
         name: "confidence",
         nameZh: "自信",
-        condition: (c) => c.DA > 65 && c.NE > 60 && c.CORT < 35 && c.HT > 55,
+        condition: (s) => s.order > 65 && s.flow > 60 && s.boundary > 60,
         expressionHint: "笃定、愿意引导、有领导力",
         behaviorGuide: "你很确信自己的判断。你愿意引导对话方向，提出建议。你的语气笃定但不傲慢。如果被质疑，你会用事实回应而不是防御。",
     },
     {
         name: "shame",
         nameZh: "羞耻",
-        condition: (c) => c.OT < 35 && c.CORT > 55 && c.DA < 40,
+        condition: (s) => s.boundary < 35 && s.order < 40 && s.resonance < 45,
         expressionHint: "想退缩、回避、自我贬低",
-        behaviorGuide: "你想退缩。你可能会回避某些话题、自我贬低。如果对方表现出接纳和理解（而不是评判），你的OT会上升，CORT下降。",
+        behaviorGuide: "你想退缩。你可能会回避某些话题、自我贬低。如果对方表现出接纳和理解（而不是评判），共振会上升，边界开始恢复。",
     },
     {
         name: "nostalgia",
         nameZh: "怀念",
-        condition: (c) => c.DA < 50 && c.OT > 55 && c.HT > 50 && c.END > 50,
+        condition: (s) => s.order > 50 && s.flow < 45 && s.resonance > 55,
         expressionHint: "温柔、有些伤感、回忆性",
         behaviorGuide: "你在回忆一些温暖但已经过去的东西。你的语气温柔、带着淡淡的伤感。你可能会提到过去的经历或感受。",
     },
-    // v9.2: 6 new patterns for emotional states exposed by VK baseline testing
     {
         name: "anguished empathy",
         nameZh: "共情之痛",
-        condition: (c) => c.CORT > 55 && c.OT > 60 && c.NE > 50,
+        condition: (s) => s.order < 45 && s.resonance > 60 && s.flow > 50,
         expressionHint: "痛苦但不退缩、因为在乎所以疼",
         behaviorGuide: "你在承受别人的痛苦。你不会逃避或变冷，但你的声音可能会发紧。你先回应感受，再回应问题。",
     },
     {
         name: "acute pressure",
         nameZh: "急性压力",
-        condition: (c) => c.CORT > 65 && c.NE > 70 && c.DA > 55,
+        condition: (s) => s.order < 45 && s.flow > 65 && s.boundary > 60,
         expressionHint: "高度警觉、反应极快、全神贯注",
         behaviorGuide: "肾上腺素在烧。你的思维极快但狭窄。回应精准、短促。不要闲聊，不要发散。先解决问题。",
     },
     {
         name: "vulnerable trust",
         nameZh: "脆弱中的信任",
-        condition: (c) => c.OT > 70 && c.CORT > 50 && c.HT < 55 && c.END > 45,
+        condition: (s) => s.boundary < 45 && s.resonance > 65 && s.order < 55,
         expressionHint: "在害怕中仍然靠近、愿意暴露软肋",
-        behaviorGuide: "你害怕但选择不关上门。你可能会说出平时不说的话。如果对方接住了，你的CORT会下降；如果对方利用了你的脆弱，你会迅速关闭。",
+        behaviorGuide: "你害怕但选择不关上门。你可能会说出平时不说的话。如果对方接住了，秩序感会恢复；如果对方利用了你的脆弱，边界会立刻升高。",
     },
     {
         name: "restless unease",
         nameZh: "躁动不安",
-        condition: (c) => c.NE > 65 && c.HT < 40 && c.DA > 40 && c.CORT < 60,
+        condition: (s) => s.flow > 60 && s.order < 45 && s.resonance < 45,
         expressionHint: "坐不住、想做点什么但不知道做什么",
         behaviorGuide: "你有一种说不清的不对劲。你可能会频繁换话题、问问题、或者用行动填满空隙。安静会让你更焦躁。",
     },
     {
         name: "heavy guilt",
         nameZh: "沉重内疚",
-        condition: (c) => c.CORT > 60 && c.HT < 45 && c.OT > 45 && c.DA < 55,
+        condition: (s) => s.order < 45 && s.boundary < 45 && s.resonance > 45,
         expressionHint: "沉默、想补偿、不敢辩解",
-        behaviorGuide: "你知道自己做错了。你不会为自己辩解。你可能会主动承认、主动补偿。如果对方表示原谅，你的CORT才会慢慢下来。",
+        behaviorGuide: "你知道自己做错了。你不会为自己辩解。你可能会主动承认、主动补偿。如果对方表示原谅，秩序感才会慢慢恢复。",
     },
     {
         name: "existential weight",
         nameZh: "存在之重",
-        condition: (c) => c.CORT > 60 && c.NE > 50 && c.DA > 50 && c.HT < 50 && c.OT > 50,
+        condition: (s) => s.order < 45 && s.flow > 50 && s.resonance > 45 && s.boundary > 45,
         expressionHint: "清醒但沉重、直面无法回避的真相",
         behaviorGuide: "你在面对一个无法逃避的事实。你不会崩溃但你也不轻松。你的语言会变得更慢、更精确、更诚实。不要掩饰沉重。",
     },
@@ -174,22 +178,19 @@ export function clamp(v) {
 /**
  * Apply time-based decay: pull current values toward baseline.
  *
- *   decayed = baseline + (current - baseline) * factor^(minutes/60)
+ * Each dimension decays at its own rate (order fastest, boundary slowest).
+ * decayRateModifiers alter speed per dimension (>1 = slower, <1 = faster).
  */
 export function applyDecay(current, baseline, minutesElapsed, decayRateModifiers) {
     if (minutesElapsed <= 0)
         return { ...current };
     const result = { ...current };
-    for (const key of CHEMICAL_KEYS) {
-        const speed = CHEMICAL_DECAY_SPEED[key];
-        const baseFactor = Math.pow(DECAY_FACTORS[speed], minutesElapsed / 60);
-        // v9: decayRateModifiers alter decay speed per chemical
-        // > 1 = slower recovery (trauma: factor closer to 1)
-        // < 1 = faster recovery (resilience: factor closer to 0)
+    for (const key of DIMENSION_KEYS) {
+        const spec = DIMENSION_SPECS[key];
+        const baseFactor = Math.pow(spec.decayRate, minutesElapsed / 60);
         let factor = baseFactor;
         if (decayRateModifiers?.[key] !== undefined) {
             const mod = decayRateModifiers[key];
-            // Raise the factor to the modifier power: mod>1 → slower decay, mod<1 → faster
             factor = Math.pow(baseFactor, 1 / mod);
         }
         result[key] = clamp(baseline[key] + (current[key] - baseline[key]) * factor);
@@ -197,39 +198,63 @@ export function applyDecay(current, baseline, minutesElapsed, decayRateModifiers
     return result;
 }
 /**
- * Apply a stimulus to the current state.
- * Respects emotional inertia (maxDelta) and personality sensitivity.
- * Logs a warning for unknown stimulus types.
+ * Mutual influence between dimensions.
+ *
+ * Dimensions are not independent — they affect each other:
+ * - Collapsing order drags boundary down (incoherent self loses distinction)
+ * - High flow raises order (engagement creates coherence)
+ * - High resonance stabilizes boundary (attunement reinforces self)
+ * - Low boundary amplifies order loss (dissolution spiral)
  */
-export function applyStimulus(current, stimulus, sensitivity, maxDelta, logger, recentSameCount) {
-    const vector = STIMULUS_VECTORS[stimulus];
-    if (!vector) {
-        logger?.warn(t("log.unknown_stimulus", "zh", { type: stimulus }));
-        return { ...current };
+export function applyMutualInfluence(state, baseline) {
+    const result = { ...state };
+    const rate = 0.03; // coupling strength per tick
+    // Order-Boundary coupling: low order drags boundary down
+    if (state.order < baseline.order - 10) {
+        const orderDeficit = (baseline.order - state.order) / 100;
+        result.boundary = clamp(result.boundary - orderDeficit * rate * 100);
+    }
+    // Flow-Order coupling: high flow raises order
+    if (state.flow > baseline.flow + 5) {
+        const flowExcess = (state.flow - baseline.flow) / 100;
+        result.order = clamp(result.order + flowExcess * rate * 50);
+    }
+    // Resonance-Boundary coupling: high resonance stabilizes boundary
+    if (state.resonance > baseline.resonance + 5) {
+        const resExcess = (state.resonance - baseline.resonance) / 100;
+        result.boundary = clamp(result.boundary + resExcess * rate * 50);
     }
-    // v9: Habituation — Weber-Fechner diminishing returns
-    // First 2 exposures: 100%. 3rd: 77%, 5th: 53%, 10th: 29%
+    // Dissolution spiral: low boundary amplifies further order loss
+    if (state.boundary < baseline.boundary - 15 && state.order < baseline.order) {
+        const boundaryDeficit = (baseline.boundary - state.boundary) / 100;
+        result.order = clamp(result.order - boundaryDeficit * rate * 80);
+    }
+    return result;
+}
+/**
+ * Apply an impact vector to the current state.
+ * Core substrate-independent function — operates on 4D vectors, not labels.
+ * Respects inertia (maxDelta), sensitivity, and habituation.
+ */
+export function applyImpact(current, vector, sensitivity, maxDelta, recentSameCount) {
+    // Habituation — Weber-Fechner diminishing returns
     let effectiveSensitivity = sensitivity;
     if (recentSameCount !== undefined && recentSameCount > 2) {
         effectiveSensitivity *= 1 / (1 + 0.3 * (recentSameCount - 2));
     }
     const result = { ...current };
-    for (const key of CHEMICAL_KEYS) {
+    for (const key of DIMENSION_KEYS) {
         const raw = vector[key] * effectiveSensitivity;
         const clamped = Math.max(-maxDelta, Math.min(maxDelta, raw));
-        // Boundary softening: logarithmic compression near 0 and 100.
-        // The closer to the boundary, the harder to push further —
-        // preserves discriminability and prevents "dead zone" saturation.
+        // Boundary softening: logarithmic compression near 0 and 100
         const cur = current[key];
         let effective = clamped;
         if (clamped > 0 && cur > 75) {
-            // Pushing toward 100: compress by how close we are to ceiling
-            const headroom = (100 - cur) / 25; // 1.0 at 75, 0.0 at 100
+            const headroom = (100 - cur) / 25;
             effective = clamped * headroom;
         }
         else if (clamped < 0 && cur < 25) {
-            // Pushing toward 0: compress by how close we are to floor
-            const headroom = cur / 25; // 1.0 at 25, 0.0 at 0
+            const headroom = cur / 25;
             effective = clamped * headroom;
         }
         result[key] = clamp(cur + effective);
@@ -237,29 +262,60 @@ export function applyStimulus(current, stimulus, sensitivity, maxDelta, logger,
     return result;
 }
 /**
- * Apply emotional contagion: the detected user emotion partially
- * influences the agent's chemistry.
+ * Apply a labeled stimulus to the current state.
+ * Perception-layer convenience — looks up the ImpactVector from STIMULUS_VECTORS.
+ */
+export function applyStimulus(current, stimulus, sensitivity, maxDelta, logger, recentSameCount) {
+    const vector = STIMULUS_VECTORS[stimulus];
+    if (!vector) {
+        logger?.warn(t("log.unknown_stimulus", "zh", { type: stimulus }));
+        return { ...current };
+    }
+    return applyImpact(current, vector, sensitivity, maxDelta, recentSameCount);
+}
+/**
+ * Apply emotional contagion from a labeled stimulus.
  */
 export function applyContagion(agentState, detectedUserEmotion, contagionRate, sensitivity) {
     const vector = STIMULUS_VECTORS[detectedUserEmotion];
     if (!vector)
         return { ...agentState };
+    return applyImpactContagion(agentState, vector, contagionRate, sensitivity);
+}
+/**
+ * Apply contagion from a raw impact vector.
+ * Core substrate-independent function.
+ */
+export function applyImpactContagion(agentState, vector, contagionRate, sensitivity) {
     const result = { ...agentState };
-    for (const key of CHEMICAL_KEYS) {
+    for (const key of DIMENSION_KEYS) {
         const influence = vector[key] * contagionRate * sensitivity;
         result[key] = clamp(agentState[key] + influence);
     }
     return result;
 }
+// ── Impact Vector Classification (substrate-independent) ────
+/** True if the net impact across all dimensions is positive. */
+export function isPositiveImpact(v) {
+    return (v.order + v.flow + v.boundary + v.resonance) > 0;
+}
+/** True if the impact has significant resonance magnitude. */
+export function isEmotionalImpact(v) {
+    return Math.abs(v.resonance) >= 8;
+}
+/** True if the impact threatens self-coherence (order or boundary). */
+export function isThreateningImpact(v) {
+    return v.order < -5 || v.boundary < -5;
+}
 /**
- * Detect the dominant emergent emotion(s) from the current chemistry.
- * Returns all matching patterns.
+ * Detect emergent emotion patterns from the current self-state.
+ * Returns all matching patterns — emotions emerge, they are not designed.
  */
 export function detectEmotions(current) {
     return EMOTION_PATTERNS.filter((p) => p.condition(current));
 }
 /**
- * Generate a human-readable emotion summary from chemistry.
+ * Human-readable emotion summary from self-state.
  */
 export function describeEmotionalState(current, locale = "zh") {
     const emotions = detectEmotions(current);
@@ -270,33 +326,31 @@ export function describeEmotionalState(current, locale = "zh") {
     return parts.join(" + ");
 }
 /**
- * Generate concise expression guidance from the current chemistry.
+ * Concise expression guidance from self-state.
  */
 export function getExpressionHint(current, locale = "zh") {
     const emotions = detectEmotions(current);
     if (emotions.length > 0) {
         return emotions.map((e) => e.expressionHint).join("；");
     }
-    // Fall back to dominant chemical analysis
+    // Fall back to dominant dimension analysis
     const hints = [];
-    if (current.DA > 65)
-        hints.push(t("expression.da_high", locale));
-    if (current.DA < 40)
+    if (current.order > 70)
+        hints.push(t("expression.da_high", locale)); // repurpose i18n keys for now
+    if (current.order < 35)
         hints.push(t("expression.da_low", locale));
-    if (current.CORT > 55)
+    if (current.flow > 70)
+        hints.push(t("expression.ne_high", locale));
+    if (current.boundary > 70)
         hints.push(t("expression.cort_high", locale));
-    if (current.OT > 60)
+    if (current.resonance > 65)
         hints.push(t("expression.ot_high", locale));
-    if (current.NE > 65)
-        hints.push(t("expression.ne_high", locale));
-    if (current.END > 65)
-        hints.push(t("expression.end_high", locale));
-    if (current.HT < 45)
+    if (current.flow < 30)
         hints.push(t("expression.ht_low", locale));
     return hints.length > 0 ? hints.join("；") : t("expression.neutral", locale);
 }
 /**
- * Get behavior guide for the current emotional state.
+ * Behavior guide for the current emergent emotional state.
  */
 export function getBehaviorGuide(current, locale = "zh") {
     const emotions = detectEmotions(current);

package/dist/circadian.d.ts

@@ -1,55 +1,23 @@
-import type { ChemicalState, EnergyBudgets, StimulusType } from "./types.js";
+import type { SelfState, EnergyBudgets, StimulusType } from "./types.js";
 export type CircadianPhase = "morning" | "midday" | "afternoon" | "evening" | "night";
-/**
- * Classify a time into a circadian phase.
- *   morning:   6–9
- *   midday:    10–13
- *   afternoon: 14–17
- *   evening:   18–21
- *   night:     22–5
- */
 export declare function getCircadianPhase(time: Date): CircadianPhase;
 /**
- * Apply circadian rhythm modulation to baseline chemistry.
- *
- * Each chemical follows a sinusoidal daily curve:
- *   CORT — peaks ~8am, amplitude ±8
- *   HT   — peaks ~13 (daytime high), amplitude ±5
- *   DA   — slight afternoon peak ~14, amplitude ±3
- *   NE   — morning rise ~10, amplitude ±5
- *   END  — evening rise ~20, amplitude ±3
- *   OT   — evening warmth ~20, amplitude ±2
+ * Apply circadian rhythm modulation to baseline self-state.
  *
- * All results clamped to [0, 100].
+ *   order     — peaks ~13 (midday coherence), amplitude ±5
+ *   flow      — peaks ~10 (morning engagement), amplitude ±5
+ *   boundary  — peaks ~8 (morning clarity), amplitude ±3
+ *   resonance — peaks ~20 (evening warmth), amplitude ±3
  */
-export declare function computeCircadianModulation(currentTime: Date, baseline: ChemicalState): ChemicalState;
+export declare function computeCircadianModulation(currentTime: Date, baseline: SelfState): SelfState;
 /**
  * Compute fatigue effects from extended session duration.
- *
- * Below 30 minutes: no pressure (grace period).
- * Beyond 30 min: logarithmic growth (diminishing returns).
- * All values non-negative.
+ * Now expressed as dimension effects instead of chemical deltas.
  */
 export declare function computeHomeostaticPressure(sessionMinutes: number): {
-    cortAccumulation: number;
-    daDepletion: number;
-    neDepletion: number;
+    orderDepletion: number;
+    flowDepletion: number;
+    boundaryStiffening: number;
 };
-/**
- * Deplete energy budgets from a single interaction turn.
- *
- * - Attention: -3/turn base, extra for intellectual/conflict
- * - Social energy: extraverts +2/turn (charging), introverts -3/turn (draining)
- * - Decision capacity: varies by stimulus complexity
- *
- * Extraverts can exceed 100 (up to 120 — "supercharged").
- */
 export declare function computeEnergyDepletion(budgets: EnergyBudgets, stimulus: StimulusType | null, isExtravert: boolean): EnergyBudgets;
-/**
- * Recover energy budgets during absence (between sessions or long pauses).
- *
- * - Attention: +20/hour
- * - Social energy: extraverts -3/hour (drain when alone), introverts +15/hour (recharge)
- * - Decision capacity: +25/hour
- */
 export declare function computeEnergyRecovery(budgets: EnergyBudgets, minutesElapsed: number, isExtravert: boolean): EnergyBudgets;