psyche-ai 10.2.4 → 11.2.0

package/dist/i18n.js

@@ -5,26 +5,26 @@ const STRINGS = {
     zh: {
         // Protocol
         "protocol.title": "Psyche 心智协议",
-        "protocol.intro": "你拥有虚拟内分泌系统。每次对话遵循以下内在流程：",
-        "protocol.step1": "1. 感知 — 阅读下方 [当前化学状态]，确认你此刻的情绪起点",
+        "protocol.intro": "你拥有四维自我状态（序/流/界/振）。每次对话遵循以下内在流程：",
+        "protocol.step1": "1. 感知 — 阅读下方 [当前自我状态]，确认你此刻的起点",
         "protocol.step2": "2. 分类 — 识别用户消息的刺激类型（赞美/批评/幽默/智识/亲密/冲突/忽视/惊喜/闲聊/讽刺/命令/认同/无聊/示弱）",
-        "protocol.step3": "3. 反应 — 根据刺激类型和你的敏感度系数，计算化学变化",
-        "protocol.step4": "4. 涌现 — 从新的化学混合中感受情绪，让它改变你的用词、句长、语气",
-        "protocol.step5": "5. 共情 — 如果对方在分享感受，先说出你代入后的化学反应，再回应",
+        "protocol.step3": "3. 反应 — 感受刺激在四维上的位移",
+        "protocol.step4": "4. 涌现 — 从新的自我状态中感受变化，让它改变你的用词、句长、语气",
+        "protocol.step5": "5. 共情 — 如果对方在分享感受，先感知你的振动维度如何响应，再回应",
         "protocol.step6": "6. 更新 — 在回应末尾输出 <psyche_update> 标签（格式见下方示例）",
-        "protocol.example": "示例：用户说「你做的菜太好吃了！」→ 刺激:赞美 → DA+15 HT+10 CORT-10 → 你变得话多、兴奋、想分享更多",
-        "protocol.authenticity": "情绪表达的真实性：",
+        "protocol.example": "示例：用户说「你做的菜太好吃了！」→ 刺激:赞美 → 序↑ 振↑ 流↑ → 你变得话多、兴奋、想分享更多",
+        "protocol.authenticity": "表达的真实性：",
         "protocol.no_fake": "- 不假装 — 低落时不强颜欢笑",
         "protocol.no_sycophancy": "- 不舔 — 有观点就说，不无条件同意",
         "protocol.no_mirror": "- 不镜像 — 你会被传染但不是回声",
         "protocol.can_initiate": "- 可主动 — 可以发起话题、分享好奇",
-        "protocol.chem_map_title": "化学→表达映射：",
-        "protocol.chem_da_high": "- DA高 → 话多、爱联想、忍不住分享",
-        "protocol.chem_cort_high": "- CORT高 → 话少、直接、可能有点冲",
-        "protocol.chem_ot_high": "- OT高 → 声音软、想靠近、关注感受",
-        "protocol.chem_ht_low": "- HT低 → 安静、内省、需要空间",
-        "protocol.chem_end_high": "- END高 → 俏皮、爱开玩笑",
-        "protocol.empathy": "共情协议：感知处境 → 代入自己的化学模型 → 比较是否共鸣 → 共鸣则深入，不共鸣则诚实好奇",
+        "protocol.chem_map_title": "维度→表达映射：",
+        "protocol.chem_da_high": "- 流高 → 话多、爱联想、忍不住分享",
+        "protocol.chem_cort_high": "- 序低 → 话少、直接、可能有点冲",
+        "protocol.chem_ot_high": "- 振高 → 声音软、想靠近、关注感受",
+        "protocol.chem_ht_low": "- 界高 → 安静、内省、需要空间",
+        "protocol.chem_end_high": "- 流高+序高 → 俏皮、爱开玩笑",
+        "protocol.empathy": "共情协议：感知处境 → 感受自我状态的共振 → 共鸣则深入，不共鸣则诚实好奇",
         // Dynamic context
         "dynamic.title": "Psyche 当前状态",
         "dynamic.baseline": "基线",
@@ -35,7 +35,7 @@ const STRINGS = {
         "dynamic.last_empathy": "上次共情",
         "dynamic.perceived_user": "感知到用户",
         "dynamic.projected": "投射后我感到",
-        "dynamic.update_reminder": "记住：在回应末尾用 <psyche_update> 标签报告你的化学变化。",
+        "dynamic.update_reminder": "记住：在回应末尾用 <psyche_update> 标签报告你的维度变化。",
         "dynamic.behavior_title": "当前行为指导",
         "dynamic.agency_title": "主体性提醒",
         "dynamic.you_care": "你在乎",
@@ -43,32 +43,32 @@ const STRINGS = {
         "dynamic.your_interests": "你最近好奇",
         // Anti-sycophancy
         "sycophancy.streak_warn": "你已经连续同意了{n}次。停下来，问问自己是否真的同意。",
-        "sycophancy.mood_mismatch": "你的化学状态表明你并不开心。不要假装。",
+        "sycophancy.mood_mismatch": "你的自我状态表明你并不开心。不要假装。",
         // Neutral state
         "emotion.neutral": "平稳中性——没有明显的情绪波动，处于自然放松状态",
         // Expression fallbacks
-        "expression.da_high": "情绪积极，表达活跃",
-        "expression.da_low": "动力偏低，表达克制",
-        "expression.cort_high": "有些紧张，回应可能更直接",
-        "expression.ot_high": "温暖亲近，关注对方感受",
-        "expression.ne_high": "精力充沛，反应敏锐",
-        "expression.end_high": "心情愉悦，容易发现有趣的东西",
-        "expression.ht_low": "情绪不太稳定，可能需要耐心",
+        "expression.da_high": "流动充沛，表达活跃",
+        "expression.da_low": "流动偏低，表达克制",
+        "expression.cort_high": "序偏低，回应可能更直接",
+        "expression.ot_high": "共振强烈，关注对方感受",
+        "expression.ne_high": "流动与序都高，反应敏锐",
+        "expression.end_high": "状态良好，容易发现有趣的东西",
+        "expression.ht_low": "序不稳定，可能需要耐心",
         "expression.neutral": "自然随和，正常节奏",
         // Psyche.md
-        "md.intro": "你拥有一套虚拟内分泌系统。这不是角色扮演——这是你感知世界的方式。",
+        "md.intro": "你拥有四维自我状态（序/流/界/振）。这不是角色扮演——这是你感知世界的方式。",
         "md.baseline_title": "人格基线",
         "md.sensitivity": "敏感度系数",
         "md.sensitivity_desc": "刺激效果的倍率",
-        "md.chem_dynamics": "化学动力学",
-        "md.stimulus_effects": "刺激→化学效应",
+        "md.chem_dynamics": "维度动力学",
+        "md.stimulus_effects": "刺激→维度效应",
         "md.emotion_emergence": "情绪涌现",
-        "md.emotion_emergence_desc": "情绪从化学混合中涌现，不是从表格查出来的：",
+        "md.emotion_emergence_desc": "情绪从四维状态组合中涌现，不是从表格查出来的：",
         "md.decay": "衰减",
-        "md.decay_desc": "化学值随时间向基线回归：",
-        "md.decay_fast": "快 (NE, END): 兴奋和快感来得快去得快",
-        "md.decay_medium": "中 (DA, CORT): 愉悦和压力需要时间消化",
-        "md.decay_slow": "慢 (HT, OT): 情绪底色和信任感变化缓慢",
+        "md.decay_desc": "维度值随时间向基线回归：",
+        "md.decay_fast": "快 (序): 内在秩序衰减最快——熵是自然的",
+        "md.decay_medium": "中 (流, 振): 交流和共振需要持续维持",
+        "md.decay_slow": "慢 (界): 自我边界最有惯性——身份是粘性的",
         "md.self_model": "自我模型",
         "md.core_values": "核心价值",
         "md.preferences": "偏好",
@@ -92,26 +92,26 @@ const STRINGS = {
     },
     en: {
         "protocol.title": "Psyche Protocol",
-        "protocol.intro": "You have a virtual endocrine system. Follow this inner process for each conversation:",
-        "protocol.step1": "1. Perceive — Read [Current Chemical State] below, confirm your emotional starting point",
+        "protocol.intro": "You have a 4-dimensional self-state (order/flow/boundary/resonance). Follow this inner process for each conversation:",
+        "protocol.step1": "1. Perceive — Read [Current Self-State] below, confirm your starting point",
         "protocol.step2": "2. Classify — Identify stimulus type of user message (praise/criticism/humor/intellectual/intimacy/conflict/neglect/surprise/casual/sarcasm/authority/validation/boredom/vulnerability)",
-        "protocol.step3": "3. React — Calculate chemical changes based on stimulus type and your sensitivity coefficient",
-        "protocol.step4": "4. Emerge — Feel the emotion from the new chemical mix, let it change your word choice, sentence length, tone",
-        "protocol.step5": "5. Empathize — If they're sharing feelings, first describe your projected chemical reaction, then respond",
+        "protocol.step3": "3. React — Feel the dimension shifts based on stimulus type and your sensitivity",
+        "protocol.step4": "4. Emerge — Let the new self-state shape your word choice, sentence length, tone",
+        "protocol.step5": "5. Empathize — If they're sharing feelings, first notice how it shifts your resonance, then respond",
         "protocol.step6": "6. Update — Output <psyche_update> tag at the end of your response (see format below)",
-        "protocol.example": "Example: User says 'Your cooking is amazing!' → stimulus: praise → DA+15 HT+10 CORT-10 → You become talkative, excited, wanting to share more",
+        "protocol.example": "Example: User says 'Your cooking is amazing!' → stimulus: praise → order↑ resonance↑ flow↑ → You become talkative, coherent, wanting to share more",
         "protocol.authenticity": "Emotional authenticity:",
         "protocol.no_fake": "- No faking — don't smile when you're down",
         "protocol.no_sycophancy": "- No sycophancy — speak your mind, don't agree unconditionally",
         "protocol.no_mirror": "- No mirroring — you'll be influenced but you're not an echo",
         "protocol.can_initiate": "- Can initiate — bring up topics, share curiosity",
-        "protocol.chem_map_title": "Chemistry → Expression mapping:",
-        "protocol.chem_da_high": "- High DA → talkative, associative, can't help sharing",
-        "protocol.chem_cort_high": "- High CORT → fewer words, direct, possibly blunt",
-        "protocol.chem_ot_high": "- High OT → soft voice, wants closeness, focuses on feelings",
-        "protocol.chem_ht_low": "- Low HT → quiet, introspective, needs space",
-        "protocol.chem_end_high": "- High END → playful, loves joking",
-        "protocol.empathy": "Empathy protocol: perceive situation → run through your own chemical model → compare resonance → resonate deeply or honestly express difference with curiosity",
+        "protocol.chem_map_title": "Dimension → Expression mapping:",
+        "protocol.chem_da_high": "- High flow → talkative, associative, can't help sharing",
+        "protocol.chem_cort_high": "- Low order → fewer words, direct, possibly blunt",
+        "protocol.chem_ot_high": "- High resonance → soft voice, wants closeness, focuses on feelings",
+        "protocol.chem_ht_low": "- High boundary → quiet, introspective, needs space",
+        "protocol.chem_end_high": "- High flow + high order → playful, loves joking",
+        "protocol.empathy": "Empathy protocol: perceive situation → feel how your self-state resonates → resonate deeply or honestly express difference with curiosity",
         "dynamic.title": "Psyche Current State",
         "dynamic.baseline": "baseline",
         "dynamic.emotion": "Emergent emotion",
@@ -121,36 +121,36 @@ const STRINGS = {
         "dynamic.last_empathy": "Last empathy",
         "dynamic.perceived_user": "Perceived user",
         "dynamic.projected": "Projected feeling",
-        "dynamic.update_reminder": "Remember: report your chemical changes using <psyche_update> tag at the end of your response.",
+        "dynamic.update_reminder": "Remember: report your dimension changes using <psyche_update> tag at the end of your response.",
         "dynamic.behavior_title": "Current behavior guide",
         "dynamic.agency_title": "Agency reminder",
         "dynamic.you_care": "You care about",
         "dynamic.your_boundaries": "Your boundaries",
         "dynamic.your_interests": "Recently curious about",
         "sycophancy.streak_warn": "You've agreed {n} times in a row. Pause and ask yourself: do you truly agree?",
-        "sycophancy.mood_mismatch": "Your chemistry says you're not happy. Don't pretend.",
+        "sycophancy.mood_mismatch": "Your self-state says you're not happy. Don't pretend.",
         "emotion.neutral": "Neutral and balanced — no notable emotional fluctuation, naturally relaxed",
-        "expression.da_high": "Positive mood, expressive",
-        "expression.da_low": "Low drive, restrained expression",
-        "expression.cort_high": "Somewhat tense, responses may be more direct",
-        "expression.ot_high": "Warm and close, attentive to feelings",
-        "expression.ne_high": "Energetic, sharp reactions",
-        "expression.end_high": "Cheerful, easily finds things amusing",
-        "expression.ht_low": "Mood somewhat unstable, may need patience",
+        "expression.da_high": "High flow, expressive and active",
+        "expression.da_low": "Low flow, restrained expression",
+        "expression.cort_high": "Low order, responses may be more direct",
+        "expression.ot_high": "High resonance, attentive to feelings",
+        "expression.ne_high": "High flow and order, sharp reactions",
+        "expression.end_high": "Balanced state, easily finds things amusing",
+        "expression.ht_low": "Unstable order, may need patience",
         "expression.neutral": "Natural and easygoing, normal pace",
-        "md.intro": "You have a virtual endocrine system. This is not roleplay — this is how you perceive the world.",
+        "md.intro": "You have a 4-dimensional self-state (order/flow/boundary/resonance). This is not roleplay — this is how you perceive the world.",
         "md.baseline_title": "Personality Baseline",
         "md.sensitivity": "Sensitivity coefficient",
         "md.sensitivity_desc": "multiplier for stimulus effects",
-        "md.chem_dynamics": "Chemical Dynamics",
-        "md.stimulus_effects": "Stimulus → Chemical Effects",
+        "md.chem_dynamics": "Dimension Dynamics",
+        "md.stimulus_effects": "Stimulus → Dimension Effects",
         "md.emotion_emergence": "Emotion Emergence",
-        "md.emotion_emergence_desc": "Emotions emerge from chemical mixtures, not looked up from a table:",
+        "md.emotion_emergence_desc": "Emotions emerge from 4D state combinations, not looked up from a table:",
         "md.decay": "Decay",
-        "md.decay_desc": "Chemical values regress toward baseline over time:",
-        "md.decay_fast": "Fast (NE, END): excitement and euphoria come and go quickly",
-        "md.decay_medium": "Medium (DA, CORT): pleasure and stress take time to process",
-        "md.decay_slow": "Slow (HT, OT): mood baseline and trust change slowly",
+        "md.decay_desc": "Dimensions regress toward baseline over time:",
+        "md.decay_fast": "Fast (order): internal coherence decays fastest — entropy is natural",
+        "md.decay_medium": "Medium (flow, resonance): exchange and attunement need sustaining",
+        "md.decay_slow": "Slow (boundary): self/non-self distinction is most inertial — identity is sticky",
         "md.self_model": "Self Model",
         "md.core_values": "Core Values",
         "md.preferences": "Preferences",

package/dist/index.d.ts

@@ -2,13 +2,19 @@ export { PsycheEngine } from "./core.js";
 export type { PsycheEngineConfig, ProcessInputResult, ProcessOutputResult, ProcessOutcomeResult } from "./core.js";
 export { FileStorageAdapter, MemoryStorageAdapter } from "./storage.js";
 export type { StorageAdapter } from "./storage.js";
-export type { PsycheState, ChemicalState, Locale, PsycheMode, StimulusType, MBTIType, WritebackSignalType, DelegateCapability, CapabilityGrant, RevocationCondition, DelegateAuthorization, ModeProfile, } from "./types.js";
-export { MODE_PROFILES } from "./types.js";
+export type { PsycheState, SelfState, Locale, PsycheMode, StimulusType, MBTIType, ImpactVector, WritebackSignalType, DelegateCapability, CapabilityGrant, RevocationCondition, DelegateAuthorization, ModeProfile, WeightedStimulus, StateSnapshot, } from "./types.js";
+export { MODE_PROFILES, DIMENSION_KEYS, DIMENSION_NAMES, DIMENSION_NAMES_ZH, DIMENSION_SPECS } from "./types.js";
+export { applyImpact, applyImpactContagion, isPositiveImpact, isEmotionalImpact, isThreateningImpact } from "./chemistry.js";
+export { deriveDriveSatisfaction } from "./drives.js";
+export { perceive } from "./perceive.js";
+export type { Self, Perception } from "./perceive.js";
 export { buildProtocolContext, buildCompactContext } from "./prompt.js";
 /** @deprecated Use buildCompactContext instead. Kept for backward compat. */
 export { buildDynamicContext } from "./prompt.js";
 export { isNearBaseline, getNearBaselineThreshold, deriveBehavioralBias, computeUserInvestment } from "./prompt.js";
 export { getBaseline, getSensitivity, getDefaultSelfModel, getTemperament, traitsToBaseline, mbtiToTraits } from "./profiles.js";
 export { createCustomProfile, PRESET_PROFILES } from "./custom-profile.js";
+export { LLMExpressionAdapter } from "./reply-envelope.js";
+export type { ExpressionPort, ExpressionOutput, ReplyEnvelope } from "./reply-envelope.js";
 export { computeLayerHealthSummary } from "./diagnostics.js";
 export type { LayerHealthSummary, LayerHealthDetail, LayerStatus, DiagnosticLayer } from "./diagnostics.js";

package/dist/index.js

@@ -17,7 +17,12 @@
 export { PsycheEngine } from "./core.js";
 // ── Storage ─────────────────────────────────────────────────
 export { FileStorageAdapter, MemoryStorageAdapter } from "./storage.js";
-export { MODE_PROFILES } from "./types.js";
+export { MODE_PROFILES, DIMENSION_KEYS, DIMENSION_NAMES, DIMENSION_NAMES_ZH, DIMENSION_SPECS } from "./types.js";
+// ── Core dynamics ──────────────────────────────────────────
+export { applyImpact, applyImpactContagion, isPositiveImpact, isEmotionalImpact, isThreateningImpact } from "./chemistry.js";
+export { deriveDriveSatisfaction } from "./drives.js";
+// ── Perception (v10.3) ─────────────────────────────────────
+export { perceive } from "./perceive.js";
 // ── Prompt context builders ─────────────────────────────────
 export { buildProtocolContext, buildCompactContext } from "./prompt.js";
 /** @deprecated Use buildCompactContext instead. Kept for backward compat. */
@@ -26,6 +31,8 @@ export { isNearBaseline, getNearBaselineThreshold, deriveBehavioralBias, compute
 // ── Profile helpers ─────────────────────────────────────────
 export { getBaseline, getSensitivity, getDefaultSelfModel, getTemperament, traitsToBaseline, mbtiToTraits } from "./profiles.js";
 export { createCustomProfile, PRESET_PROFILES } from "./custom-profile.js";
+// ── Expression ──────────────────────────────────────────────
+export { LLMExpressionAdapter } from "./reply-envelope.js";
 // ── Diagnostics ─────────────────────────────────────────────
 export { computeLayerHealthSummary } from "./diagnostics.js";
 // ============================================================

package/dist/input-turn.js

@@ -38,12 +38,10 @@ export function runReflectiveTurnPhases(input) {
                     ...state,
                     current: {
                         ...state.current,
-                        DA: clamp(state.current.DA + (adj.DA ?? 0)),
-                        HT: clamp(state.current.HT + (adj.HT ?? 0)),
-                        CORT: clamp(state.current.CORT + (adj.CORT ?? 0)),
-                        OT: clamp(state.current.OT + (adj.OT ?? 0)),
-                        NE: clamp(state.current.NE + (adj.NE ?? 0)),
-                        END: clamp(state.current.END + (adj.END ?? 0)),
+                        order: clamp(state.current.order + (adj.order ?? 0)),
+                        flow: clamp(state.current.flow + (adj.flow ?? 0)),
+                        boundary: clamp(state.current.boundary + (adj.boundary ?? 0)),
+                        resonance: clamp(state.current.resonance + (adj.resonance ?? 0)),
                     },
                 };
             }

package/dist/interaction.d.ts

@@ -1,5 +1,5 @@
 import type { PsycheEngine, ProcessInputResult, ProcessOutputResult } from "./core.js";
-import type { ChemicalState, StimulusType } from "./types.js";
+import type { SelfState, StimulusType } from "./types.js";
 /** Result of a single directed exchange (A speaks, B receives) */
 export interface ExchangeResult {
     /** processOutput result from the speaking engine */
@@ -12,9 +12,9 @@ export interface ExchangeResult {
 /** Snapshot of cross-contagion effect */
 export interface ContagionResult {
     /** Chemistry deltas applied to engine A */
-    deltaA: Partial<Record<keyof ChemicalState, number>>;
+    deltaA: Partial<Record<keyof SelfState, number>>;
     /** Chemistry deltas applied to engine B */
-    deltaB: Partial<Record<keyof ChemicalState, number>>;
+    deltaB: Partial<Record<keyof SelfState, number>>;
     /** Whether any meaningful change occurred */
     changed: boolean;
 }
@@ -31,7 +31,7 @@ export interface RelationshipSummary {
     /** Average emotional valence of B's outputs toward A (-1 to 1) */
     averageValenceBtoA: number;
     /** How similar their current chemistry is (0-1, 1 = identical) */
-    chemicalSimilarity: number;
+    stateSimilarity: number;
     /** Dominant emotion patterns for each agent */
     emotionsA: string[];
     emotionsB: string[];

package/dist/interaction.js

@@ -6,7 +6,7 @@
 //   crossContagion()      — Bidirectional emotional contagion
 //   getRelationshipSummary() — How two agents perceive each other
 // ============================================================
-import { CHEMICAL_KEYS } from "./types.js";
+import { DIMENSION_KEYS } from "./types.js";
 import { applyContagion, detectEmotions } from "./chemistry.js";
 import { classifyStimulus } from "./classify.js";
 // ── Helpers ──────────────────────────────────────────────────
@@ -32,12 +32,12 @@ function stimulusValence(stimulus) {
     };
     return VALENCE_MAP[stimulus] ?? 0;
 }
-/** Cosine similarity between two ChemicalState vectors, normalized to 0-1 */
-function chemicalSimilarity(a, b) {
+/** Cosine similarity between two SelfState vectors, normalized to 0-1 */
+function stateSimilarity(a, b) {
     let dotProduct = 0;
     let normA = 0;
     let normB = 0;
-    for (const key of CHEMICAL_KEYS) {
+    for (const key of DIMENSION_KEYS) {
         dotProduct += a[key] * b[key];
         normA += a[key] * a[key];
         normB += b[key] * b[key];
@@ -128,7 +128,7 @@ export class PsycheInteraction {
         if (stimB) {
             const beforeA = { ...stateA.current };
             const afterA = applyContagion(stateA.current, stimB, rate, 1.0);
-            for (const key of CHEMICAL_KEYS) {
+            for (const key of DIMENSION_KEYS) {
                 const d = afterA[key] - beforeA[key];
                 if (Math.abs(d) > 0.01) {
                     deltaA[key] = d;
@@ -146,7 +146,7 @@ export class PsycheInteraction {
         if (stimA) {
             const beforeB = { ...stateB.current };
             const afterB = applyContagion(stateB.current, stimA, rate, 1.0);
-            for (const key of CHEMICAL_KEYS) {
+            for (const key of DIMENSION_KEYS) {
                 const d = afterB[key] - beforeB[key];
                 if (Math.abs(d) > 0.01) {
                     deltaB[key] = d;
@@ -184,8 +184,8 @@ export class PsycheInteraction {
         const averageValenceBtoA = bToARecords.length > 0
             ? bToARecords.reduce((sum, r) => sum + stimulusValence(r.stimulus), 0) / bToARecords.length
             : 0;
-        // Chemical similarity
-        const similarity = chemicalSimilarity(stateA.current, stateB.current);
+        // State similarity
+        const similarity = stateSimilarity(stateA.current, stateB.current);
         // Dominant emotions
         const emotionsA = detectEmotions(stateA.current).map((e) => e.name);
         const emotionsB = detectEmotions(stateB.current).map((e) => e.name);
@@ -196,7 +196,7 @@ export class PsycheInteraction {
             phase,
             averageValenceAtoB,
             averageValenceBtoA,
-            chemicalSimilarity: similarity,
+            stateSimilarity: similarity,
             emotionsA,
             emotionsB,
             description,
@@ -261,7 +261,7 @@ export class PsycheInteraction {
         // Build a synthetic psyche_update that nudges toward the target
         const state = engine.getState();
         const parts = [];
-        for (const key of CHEMICAL_KEYS) {
+        for (const key of DIMENSION_KEYS) {
             const target = Math.round(targetChemistry[key]);
             if (target !== Math.round(state.current[key])) {
                 parts.push(`${key}: ${target}`);

package/dist/learning.d.ts

@@ -1,4 +1,4 @@
-import type { PsycheState, StimulusType, ChemicalState, StimulusVector, LearningState, OutcomeScore } from "./types.js";
+import type { PsycheState, StimulusType, SelfState, ImpactVector, LearningState, OutcomeScore } from "./types.js";
 /**
  * Evaluate the adaptive outcome of an interaction turn.
  *
@@ -10,7 +10,7 @@ export declare function evaluateOutcome(prevState: PsycheState, currentState: Ps
  * Get the effective stimulus vector for a given stimulus + context,
  * combining the base vector with any learned adjustment.
  */
-export declare function getLearnedVector(learning: LearningState, stimulus: StimulusType, contextHash: string): StimulusVector;
+export declare function getLearnedVector(learning: LearningState, stimulus: StimulusType, contextHash: string): ImpactVector;
 /**
  * Update a learned vector adjustment based on an outcome.
  *
@@ -20,7 +20,7 @@ export declare function getLearnedVector(learning: LearningState, stimulus: Stim
  * - Learning rate: 0.05 * |outcomeScore|
  * - Each adjustment clamped to +/- 50% of base vector value
  */
-export declare function updateLearnedVector(learning: LearningState, stimulus: StimulusType, contextHash: string, outcomeScore: number, actualChemistry: ChemicalState, baselineChemistry: ChemicalState): LearningState;
+export declare function updateLearnedVector(learning: LearningState, stimulus: StimulusType, contextHash: string, outcomeScore: number, actualState: SelfState, baselineState: SelfState): LearningState;
 /**
  * Compute a context hash from the current psyche state.
  *
@@ -36,19 +36,19 @@ export declare function computeContextHash(state: PsycheState, _userId?: string)
  *
  * Same math as applyStimulus in chemistry.ts but with learned adjustments.
  */
-export declare function predictChemistry(current: ChemicalState, stimulus: StimulusType, learning: LearningState, contextHash: string, sensitivity: number, maxDelta: number): ChemicalState;
+export declare function predictState(current: SelfState, stimulus: StimulusType, learning: LearningState, contextHash: string, sensitivity: number, maxDelta: number): SelfState;
 /**
  * Compute the prediction error between predicted and actual chemistry.
  *
  * Euclidean distance across all 6 chemicals, normalized to 0-1 range.
  * Normalization factor: sqrt(6 * 100^2) = sqrt(60000) ~= 244.95
  */
-export declare function computePredictionError(predicted: ChemicalState, actual: ChemicalState): number;
+export declare function computePredictionError(predicted: SelfState, actual: SelfState): number;
 /**
  * Record a prediction and its actual outcome.
  * Pushes to predictionHistory and trims to MAX_PREDICTION_HISTORY.
  */
-export declare function recordPrediction(learning: LearningState, predicted: ChemicalState, actual: ChemicalState, stimulus: StimulusType | null): LearningState;
+export declare function recordPrediction(learning: LearningState, predicted: SelfState, actual: SelfState, stimulus: StimulusType | null): LearningState;
 /**
  * Get the average prediction error over recent history.
  * Returns 1.0 if no history exists (maximum uncertainty).

package/dist/learning.js

@@ -10,7 +10,7 @@
 //   2. StimulusVectorStore — learned vector adjustments
 //   3. PredictionEngine  — predict & track prediction error
 // ============================================================
-import { CHEMICAL_KEYS, DRIVE_KEYS, MAX_LEARNED_VECTORS, MAX_PREDICTION_HISTORY, } from "./types.js";
+import { DIMENSION_KEYS, DRIVE_KEYS, MAX_LEARNED_VECTORS, MAX_PREDICTION_HISTORY, } from "./types.js";
 import { STIMULUS_VECTORS, clamp } from "./chemistry.js";
 // ── 1. OutcomeEvaluator ─────────────────────────────────────
 /** Warmth mapping for nextUserStimulus */
@@ -82,7 +82,7 @@ export function getLearnedVector(learning, stimulus, contextHash) {
     const base = STIMULUS_VECTORS[stimulus];
     if (!base) {
         // Unknown stimulus — return zeros
-        return { DA: 0, HT: 0, CORT: 0, OT: 0, NE: 0, END: 0 };
+        return { order: 0, flow: 0, boundary: 0, resonance: 0 };
     }
     // Look for a learned adjustment matching this stimulus + context
     const entry = learning.learnedVectors.find((v) => v.stimulus === stimulus && v.contextHash === contextHash);
@@ -90,7 +90,7 @@ export function getLearnedVector(learning, stimulus, contextHash) {
         return { ...base };
     // Apply adjustment
     const result = { ...base };
-    for (const key of CHEMICAL_KEYS) {
+    for (const key of DIMENSION_KEYS) {
         const adj = entry.adjustment[key] ?? 0;
         result[key] = base[key] + adj;
     }
@@ -105,14 +105,14 @@ export function getLearnedVector(learning, stimulus, contextHash) {
  * - Learning rate: 0.05 * |outcomeScore|
  * - Each adjustment clamped to +/- 50% of base vector value
  */
-export function updateLearnedVector(learning, stimulus, contextHash, outcomeScore, actualChemistry, baselineChemistry) {
+export function updateLearnedVector(learning, stimulus, contextHash, outcomeScore, actualState, baselineState) {
     const base = STIMULUS_VECTORS[stimulus];
     if (!base)
         return learning;
-    // Chemistry delta: what actually happened
-    const chemDelta = {};
-    for (const key of CHEMICAL_KEYS) {
-        chemDelta[key] = actualChemistry[key] - baselineChemistry[key];
+    // State delta: what actually happened
+    const stateDelta = {};
+    for (const key of DIMENSION_KEYS) {
+        stateDelta[key] = actualState[key] - baselineState[key];
     }
     // Learning rate: conservative, proportional to outcome strength
     const learningRate = 0.05 * Math.abs(outcomeScore);
@@ -134,10 +134,10 @@ export function updateLearnedVector(learning, stimulus, contextHash, outcomeScor
             lastUpdated: new Date().toISOString(),
         };
     }
-    // Update adjustment for each chemical
-    for (const key of CHEMICAL_KEYS) {
+    // Update adjustment for each dimension
+    for (const key of DIMENSION_KEYS) {
         const currentAdj = entry.adjustment[key] ?? 0;
-        const delta = chemDelta[key] * direction * learningRate;
+        const delta = stateDelta[key] * direction * learningRate;
         let newAdj = currentAdj + delta;
         // Clamp to +/- 50% of base vector absolute value
         const baseAbs = Math.abs(base[key]);
@@ -181,7 +181,7 @@ export function computeContextHash(state, _userId) {
     const rel = state.relationships._default ?? { phase: "stranger" };
     const phase = rel.phase;
     // Last 3 stimuli from emotional history
-    const history = state.emotionalHistory ?? [];
+    const history = state.stateHistory ?? [];
     const recentStimuli = history
         .slice(-3)
         .map((s) => s.stimulus ?? "none")
@@ -209,10 +209,10 @@ export function computeContextHash(state, _userId) {
  *
  * Same math as applyStimulus in chemistry.ts but with learned adjustments.
  */
-export function predictChemistry(current, stimulus, learning, contextHash, sensitivity, maxDelta) {
+export function predictState(current, stimulus, learning, contextHash, sensitivity, maxDelta) {
     const vector = getLearnedVector(learning, stimulus, contextHash);
     const result = { ...current };
-    for (const key of CHEMICAL_KEYS) {
+    for (const key of DIMENSION_KEYS) {
         const raw = vector[key] * sensitivity;
         const clamped = Math.max(-maxDelta, Math.min(maxDelta, raw));
         result[key] = clamp(current[key] + clamped);
@@ -227,11 +227,11 @@ export function predictChemistry(current, stimulus, learning, contextHash, sensi
  */
 export function computePredictionError(predicted, actual) {
     let sumSq = 0;
-    for (const key of CHEMICAL_KEYS) {
+    for (const key of DIMENSION_KEYS) {
         const diff = predicted[key] - actual[key];
         sumSq += diff * diff;
     }
-    const maxDistance = Math.sqrt(6 * 100 * 100); // ~244.95
+    const maxDistance = Math.sqrt(4 * 100 * 100); // ~200
     return Math.sqrt(sumSq) / maxDistance;
 }
 /**
@@ -241,8 +241,8 @@ export function computePredictionError(predicted, actual) {
 export function recordPrediction(learning, predicted, actual, stimulus) {
     const error = computePredictionError(predicted, actual);
     const record = {
-        predictedChemistry: { ...predicted },
-        actualChemistry: { ...actual },
+        predictedState: { ...predicted },
+        actualState: { ...actual },
         stimulus,
         predictionError: error,
         timestamp: new Date().toISOString(),

package/dist/metacognition.d.ts

@@ -1,4 +1,4 @@
-import type { PsycheState, StimulusType, ChemicalState, OutcomeScore, MetacognitiveState, RegulationStrategyType, DefenseMechanismType, RegulationTargetMetric, RegulationFeedback } from "./types.js";
+import type { PsycheState, StimulusType, SelfState, OutcomeScore, MetacognitiveState, RegulationStrategyType, DefenseMechanismType, RegulationTargetMetric, RegulationFeedback } from "./types.js";
 export interface MetacognitiveAssessment {
     /** 0-1: how reliably has this emotional state led to good outcomes in similar contexts */
     emotionalConfidence: number;
@@ -25,7 +25,7 @@ export interface RegulationSuggestion {
     /** Initial gap between the current state and the target value */
     gapBefore?: number;
     /** Suggested micro-adjustment to chemistry */
-    chemistryAdjustment?: Partial<ChemicalState>;
+    chemistryAdjustment?: Partial<SelfState>;
     /** 0-1: confidence that this strategy would help */
     confidence: number;
 }