psyche-ai 10.2.3 → 11.2.0

package/dist/psyche-file.d.ts

@@ -1,4 +1,4 @@
-import type { PsycheState, MBTIType, ChemicalState, RelationshipState, Locale, StimulusType, ChemicalSnapshot, WritebackSignalType } from "./types.js";
+import type { PsycheState, MBTIType, SelfState, RelationshipState, Locale, StimulusType, StateSnapshot, WritebackSignalType } from "./types.js";
 export interface SemanticTurnSummary {
     summary: string;
     points?: string[];
@@ -24,7 +24,7 @@ export declare function summarizeTurnSemantic(text: string, locale?: Locale, opt
  * Compress a batch of snapshots into a concise session summary string.
  * Format: "3月23日(5轮): 刺激[casual×3, praise×2] 趋势[DA↑OT↑] 情绪[自然→满足]"
  */
-export declare function compressSnapshots(snapshots: ChemicalSnapshot[]): string;
+export declare function compressSnapshots(snapshots: StateSnapshot[]): string;
 /**
  * Push a chemical snapshot to emotional history, keeping max entries.
  * When history overflows, compresses removed entries into relationship memory.
@@ -35,7 +35,7 @@ export declare function pushSnapshot(state: PsycheState, stimulus: StimulusType
  */
 export declare function getRelationship(state: PsycheState, userId?: string): RelationshipState;
 /**
- * Compress the full emotionalHistory into a rich session summary and store it
+ * Compress the full stateHistory into a rich session summary and store it
  * in the user's relationship.memory[]. Called ONCE at session end.
  *
  * Pure computation, no LLM calls.
@@ -45,22 +45,22 @@ export declare function compressSession(state: PsycheState, userId?: string): Ps
  * Compute snapshot intensity: how far current chemistry deviates from baseline.
  * Returns 0-1 (0 = at baseline, 1 = maximum possible deviation).
  */
-export declare function computeSnapshotIntensity(current: ChemicalState, baseline: ChemicalState): number;
+export declare function computeSnapshotIntensity(current: SelfState, baseline: SelfState): number;
 /**
  * Compute emotional valence from chemistry.
  * Returns -1 (negative) to 1 (positive).
  */
-export declare function computeSnapshotValence(chemistry: ChemicalState): number;
+export declare function computeSnapshotValence(state: SelfState): number;
 /**
  * Consolidate emotional history: mark core memories, fade weak ones.
  * Called at session end or when history overflows.
  */
-export declare function consolidateHistory(snapshots: ChemicalSnapshot[], maxEntries?: number): ChemicalSnapshot[];
+export declare function consolidateHistory(snapshots: StateSnapshot[], maxEntries?: number): StateSnapshot[];
 /**
  * Retrieve memories related to current chemistry and stimulus.
  * Uses chemical similarity + stimulus matching + core memory bonus.
  */
-export declare function retrieveRelatedMemories(history: ChemicalSnapshot[], currentChemistry: ChemicalState, stimulus: StimulusType | null, limit?: number): ChemicalSnapshot[];
+export declare function retrieveRelatedMemories(history: StateSnapshot[], currentState: SelfState, stimulus: StimulusType | null, limit?: number): StateSnapshot[];
 /**
  * Load psyche state from workspace. Auto-initializes if missing.
  * Handles v1→v2 migration transparently.

package/dist/psyche-file.js

@@ -4,10 +4,10 @@
 // ============================================================
 import { readFile, writeFile, access, rename, constants, mkdir } from "node:fs/promises";
 import { dirname, join } from "node:path";
-import { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, DEFAULT_PERSONHOOD_STATE, MAX_EMOTIONAL_HISTORY, MAX_RELATIONSHIP_MEMORY, } from "./types.js";
+import { DIMENSION_KEYS, DIMENSION_NAMES, DIMENSION_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, DEFAULT_PERSONHOOD_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, updateTraitDrift } from "./drives.js";
+import { deriveDriveSatisfaction, computeEffectiveBaseline, updateTraitDrift } from "./drives.js";
 import { t } from "./i18n.js";
 import { computeSelfReflection } from "./self-recognition.js";
 const STATE_FILE = "psyche-state.json";
@@ -199,10 +199,10 @@ export function compressSnapshots(snapshots) {
         .sort((a, b) => b[1] - a[1])
         .map(([type, count]) => `${type}×${count}`)
         .join(", ");
-    // Chemical trend (first→last)
+    // Dimension trend (first→last)
     const trends = [];
-    for (const key of CHEMICAL_KEYS) {
-        const delta = last.chemistry[key] - first.chemistry[key];
+    for (const key of DIMENSION_KEYS) {
+        const delta = last.state[key] - first.state[key];
         if (delta > 8)
             trends.push(`${key}↑`);
         else if (delta < -8)
@@ -238,7 +238,7 @@ export function pushSnapshot(state, stimulus, semantic) {
     const intensity = computeSnapshotIntensity(state.current, state.baseline);
     const valence = computeSnapshotValence(state.current);
     const snapshot = {
-        chemistry: { ...state.current },
+        state: { ...state.current },
         stimulus,
         dominantEmotion,
         timestamp: new Date().toISOString(),
@@ -247,7 +247,7 @@ export function pushSnapshot(state, stimulus, semantic) {
         intensity,
         valence,
     };
-    const history = [...(state.emotionalHistory ?? []), snapshot];
+    const history = [...(state.stateHistory ?? []), snapshot];
     let updatedRelationships = state.relationships;
     if (history.length > MAX_EMOTIONAL_HISTORY) {
         // Compress the overflow entries into relationship memory
@@ -265,7 +265,7 @@ export function pushSnapshot(state, stimulus, semantic) {
             updatedRelationships = { ...state.relationships, _default: defaultRel };
         }
     }
-    return { ...state, emotionalHistory: history, relationships: updatedRelationships };
+    return { ...state, stateHistory: history, relationships: updatedRelationships };
 }
 /**
  * Get relationship for a specific user, or _default.
@@ -290,13 +290,13 @@ const TENDENCY_LABEL_EN = {
     stable: "stable",
 };
 /**
- * Compress the full emotionalHistory into a rich session summary and store it
+ * Compress the full stateHistory into a rich session summary and store it
  * in the user's relationship.memory[]. Called ONCE at session end.
  *
  * Pure computation, no LLM calls.
  */
 export function compressSession(state, userId) {
-    const history = state.emotionalHistory ?? [];
+    const history = state.stateHistory ?? [];
     // Need at least 2 entries for a meaningful summary
     if (history.length < 2)
         return state;
@@ -324,12 +324,12 @@ export function compressSession(state, userId) {
         .sort((a, b) => b[1] - a[1])
         .map(([type, count]) => `${type}×${count}`)
         .join(",");
-    // ── Chemical trajectory ──
+    // ── Dimension trajectory ──
     const trajectoryParts = [];
-    for (const key of CHEMICAL_KEYS) {
-        const delta = last.chemistry[key] - first.chemistry[key];
+    for (const key of DIMENSION_KEYS) {
+        const delta = last.state[key] - first.state[key];
         if (Math.abs(delta) > 10) {
-            trajectoryParts.push(`${key}${Math.round(first.chemistry[key])}→${Math.round(last.chemistry[key])}`);
+            trajectoryParts.push(`${key}${Math.round(first.state[key])}→${Math.round(last.state[key])}`);
         }
     }
     // ── Emotion arc ──
@@ -347,8 +347,8 @@ export function compressSession(state, userId) {
     let peakDeviation = 0;
     for (let i = 0; i < history.length; i++) {
         let deviation = 0;
-        for (const key of CHEMICAL_KEYS) {
-            deviation += Math.abs(history[i].chemistry[key] - state.baseline[key]);
+        for (const key of DIMENSION_KEYS) {
+            deviation += Math.abs(history[i].state[key] - state.baseline[key]);
         }
         if (deviation > peakDeviation) {
             peakDeviation = deviation;
@@ -414,7 +414,7 @@ export function compressSession(state, userId) {
         : [...coreMemories, lastSnapshot];
     return {
         ...state,
-        emotionalHistory: preserved,
+        stateHistory: preserved,
         relationships: updatedRelationships,
         traitDrift: updatedDrift,
     };
@@ -426,7 +426,7 @@ export function compressSession(state, userId) {
  */
 export function computeSnapshotIntensity(current, baseline) {
     let totalDeviation = 0;
-    for (const key of CHEMICAL_KEYS) {
+    for (const key of DIMENSION_KEYS) {
         totalDeviation += Math.abs(current[key] - baseline[key]);
     }
     return Math.min(1, totalDeviation / 600);
@@ -435,9 +435,10 @@ export function computeSnapshotIntensity(current, baseline) {
  * Compute emotional valence from chemistry.
  * Returns -1 (negative) to 1 (positive).
  */
-export function computeSnapshotValence(chemistry) {
-    const raw = ((chemistry.DA - 50) + (chemistry.HT - 50) + (chemistry.OT - 50)
-        + (chemistry.END - 50) - (chemistry.CORT - 50) - (chemistry.NE - 50) * 0.3) / 250;
+export function computeSnapshotValence(state) {
+    // Positive: order + resonance; Negative: low order; Flow is ambivalent
+    const raw = ((state.order - 50) + (state.resonance - 50)
+        + (state.boundary - 50) * 0.3 + (state.flow - 50) * 0.2) / 130;
     return Math.max(-1, Math.min(1, raw));
 }
 /** Core memory intensity threshold */
@@ -486,17 +487,17 @@ export function consolidateHistory(snapshots, maxEntries = MAX_EMOTIONAL_HISTORY
  * Retrieve memories related to current chemistry and stimulus.
  * Uses chemical similarity + stimulus matching + core memory bonus.
  */
-export function retrieveRelatedMemories(history, currentChemistry, stimulus, limit = 3) {
+export function retrieveRelatedMemories(history, currentState, stimulus, limit = 3) {
     if (history.length === 0)
         return [];
     const scored = history.map((snap) => {
-        // Chemical similarity (Euclidean distance normalized)
+        // State similarity (Euclidean distance normalized)
         let sumSqDiff = 0;
-        for (const key of CHEMICAL_KEYS) {
-            const diff = snap.chemistry[key] - currentChemistry[key];
+        for (const key of DIMENSION_KEYS) {
+            const diff = snap.state[key] - currentState[key];
             sumSqDiff += diff * diff;
         }
-        const maxDist = Math.sqrt(6) * 100; // theoretical max distance
+        const maxDist = Math.sqrt(4) * 100; // theoretical max distance
         const similarity = 1 - Math.sqrt(sumSqDiff) / maxDist;
         // Stimulus match bonus
         const stimulusBonus = (stimulus && snap.stimulus === stimulus) ? 0.2 : 0;
@@ -558,7 +559,7 @@ export async function loadState(workspaceDir, logger = NOOP_LOGGER) {
  */
 export function migrateToLatest(raw, fallbackName) {
     const ver = raw.version ?? 1;
-    // v1: single relationship field, no emotionalHistory
+    // v1: single relationship field, no stateHistory
     let state = raw;
     if (ver <= 1) {
         const oldRel = raw.relationship;
@@ -571,7 +572,7 @@ export function migrateToLatest(raw, fallbackName) {
             relationships: { _default: oldRel ?? { ...DEFAULT_RELATIONSHIP } },
             empathyLog: raw.empathyLog ?? null,
             selfModel: raw.selfModel,
-            emotionalHistory: [],
+            stateHistory: [],
             agreementStreak: 0,
             lastDisagreement: null,
             meta: {
@@ -618,7 +619,7 @@ export async function initializeState(workspaceDir, opts, logger = NOOP_LOGGER)
         },
         empathyLog: null,
         selfModel,
-        emotionalHistory: [],
+        stateHistory: [],
         agreementStreak: 0,
         lastDisagreement: null,
         learning: { ...DEFAULT_LEARNING_STATE },
@@ -653,13 +654,13 @@ export async function decayAndSave(workspaceDir, state) {
     const minutesElapsed = (now.getTime() - lastUpdate.getTime()) / 60000;
     if (minutesElapsed < 1)
         return state;
-    const decayedDrives = decayDrives(state.drives, minutesElapsed);
-    const effectiveBaseline = computeEffectiveBaseline(state.baseline, decayedDrives);
+    const effectiveBaseline = computeEffectiveBaseline(state.baseline, state.current);
     const decayed = applyDecay(state.current, effectiveBaseline, minutesElapsed);
+    const drives = deriveDriveSatisfaction(decayed, state.baseline);
     const updated = {
         ...state,
         current: decayed,
-        drives: decayedDrives,
+        drives,
         updatedAt: now.toISOString(),
     };
     await saveState(workspaceDir, updated);
@@ -676,12 +677,12 @@ export function parsePsycheUpdate(text, logger = NOOP_LOGGER) {
         return null;
     const block = match[1];
     const updates = {};
-    for (const key of CHEMICAL_KEYS) {
-        // Try multiple patterns: abbreviation, Chinese name, English name
+    for (const key of DIMENSION_KEYS) {
+        // Try multiple patterns: dimension name, Chinese name, English name
         const patterns = [
             new RegExp(`${key}\\s*[:：]\\s*([\\d.]+)`, "i"),
-            new RegExp(`${CHEMICAL_NAMES_ZH[key]}\\s*[:：]\\s*([\\d.]+)`),
-            new RegExp(`${CHEMICAL_NAMES[key]}\\s*[:：]\\s*([\\d.]+)`, "i"),
+            new RegExp(`${DIMENSION_NAMES_ZH[key]}\\s*[:：]\\s*([\\d.]+)`),
+            new RegExp(`${DIMENSION_NAMES[key]}\\s*[:：]\\s*([\\d.]+)`, "i"),
         ];
         for (const re of patterns) {
             const m = block.match(re);
@@ -813,17 +814,17 @@ export function detectDisagreement(text) {
  */
 export function mergeUpdates(state, updates, maxDelta, userId) {
     const merged = { ...state };
-    // Merge chemistry with inertia limit
+    // Merge state with inertia limit
     if (updates.current) {
-        const newChem = { ...state.current };
-        for (const key of CHEMICAL_KEYS) {
+        const newState = { ...state.current };
+        for (const key of DIMENSION_KEYS) {
             if (updates.current[key] !== undefined) {
                 const delta = updates.current[key] - state.current[key];
                 const clampedDelta = Math.max(-maxDelta, Math.min(maxDelta, delta));
-                newChem[key] = Math.max(0, Math.min(100, state.current[key] + clampedDelta));
+                newState[key] = Math.max(0, Math.min(100, state.current[key] + clampedDelta));
             }
         }
-        merged.current = newChem;
+        merged.current = newState;
     }
     // Merge empathy log
     if (updates.empathyLog) {
@@ -882,7 +883,7 @@ export async function generatePsycheMd(workspaceDir, state) {
     const locale = meta.locale ?? "zh";
     const temperament = state.mbti ? getTemperament(state.mbti) : "";
     const sensitivity = state.sensitivity ?? 1.0;
-    const baselineLines = CHEMICAL_KEYS.map((k) => `- ${CHEMICAL_NAMES_ZH[k]}: ${baseline[k]}`).join("\n");
+    const baselineLines = DIMENSION_KEYS.map((k) => `- ${DIMENSION_NAMES_ZH[k]}: ${baseline[k]}`).join("\n");
     const content = `# Psyche — ${meta.agentName}
 
 ${t("md.intro", locale)}
@@ -899,37 +900,37 @@ ${t("md.sensitivity", locale)}: ${sensitivity} (${t("md.sensitivity_desc", local
 
 ### ${t("md.stimulus_effects", locale)}
 
-| 刺激类型 | DA | HT | CORT | OT | NE | END |
-|---------|-----|------|------|-----|-----|-----|
-| 赞美认可 | +15 | +10 | -10 | +5 | +5 | +10 |
-| 批评否定 | -10 | -15 | +20 | -5 | +10 | -5 |
-| 幽默玩笑 | +10 | +5 | -5 | +10 | +5 | +20 |
-| 智识挑战 | +15 | 0 | +5 | 0 | +20 | +5 |
-| 亲密信任 | +10 | +15 | -15 | +25 | -5 | +15 |
-| 冲突争论 | -5 | -20 | +25 | -15 | +25 | -10 |
-| 被忽视 | -15 | -20 | +15 | -20 | -10 | -15 |
-| 惊喜新奇 | +20 | 0 | +5 | +5 | +25 | +10 |
-| 日常闲聊 | +5 | +10 | -5 | +10 | 0 | +5 |
-| 讽刺 | -5 | -10 | +15 | -10 | +15 | -5 |
-| 命令 | -10 | -5 | +20 | -15 | +15 | -10 |
-| 被认同 | +20 | +15 | -15 | +10 | +5 | +15 |
-| 无聊 | -15 | -5 | +5 | -5 | -20 | -10 |
-| 示弱 | +5 | +5 | +10 | +20 | -5 | +5 |
+| 刺激类型 | 序(order) | 流(flow) | 界(boundary) | 振(resonance) |
+|---------|-----------|----------|-------------|---------------|
+| 赞美认可 | +10 | +8 | +5 | +12 |
+| 批评否定 | -12 | +5 | -8 | -10 |
+| 幽默玩笑 | +3 | +10 | -3 | +15 |
+| 智识挑战 | +8 | +20 | +3 | +2 |
+| 亲密信任 | +12 | +5 | -10 | +20 |
+| 冲突争论 | -15 | +15 | +10 | -12 |
+| 被忽视 | -8 | -15 | +5 | -18 |
+| 惊喜新奇 | +2 | +18 | -5 | +8 |
+| 日常闲聊 | +5 | +3 | 0 | +5 |
+| 讽刺 | -8 | +8 | -5 | -12 |
+| 命令 | -5 | +5 | +12 | -15 |
+| 被认同 | +12 | +5 | +3 | +10 |
+| 无聊 | -5 | -18 | +3 | -8 |
+| 示弱 | +3 | +5 | -8 | +18 |
 
 ### ${t("md.emotion_emergence", locale)}
 
 ${t("md.emotion_emergence_desc", locale)}
-- **愉悦兴奋** = 高DA + 高NE + 低CORT
-- **深度满足** = 高HT + 高OT + 低CORT
-- **焦虑不安** = 高CORT + 高NE + 低HT
-- **亲密温暖** = 高OT + 高END + 中DA
-- **倦怠低落** = 低DA + 低NE + 中CORT
-- **专注心流** = 高NE + 高DA + 低CORT + 低OT
-- **怨恨** = 低HT + 低OT + 高CORT
-- **无聊** = 低DA + 低NE + 低CORT
-- **自信** = 高DA + 高NE + 低CORT + 高HT
-- **羞耻** = 低OT + 高CORT + 低DA
-- **怀念** = 低DA + 高OT + 高HT + 高END
+- **愉悦兴奋** = 高flow + 高order + 高resonance
+- **深度满足** = 高order + 高resonance + 低boundary
+- **焦虑不安** = 低order + 高flow + 高boundary
+- **亲密温暖** = 高resonance + 低boundary + 中flow
+- **倦怠低落** = 低flow + 低order
+- **专注心流** = 高flow + 高order + 高boundary
+- **怨恨** = 低order + 低resonance + 高boundary
+- **无聊** = 低flow + 中order
+- **自信** = 高order + 高flow + 高boundary
+- **羞耻** = 低resonance + 低order + 高boundary
+- **怀念** = 低flow + 高resonance + 高order
 
 ### ${t("md.decay", locale)}
 
@@ -953,11 +954,11 @@ ${selfModel.boundaries.map((b) => `- ${b}`).join("\n")}
 
 当对方分享感受时：
 1. 感知对方的处境
-2. 将处境代入**你自己的**化学模型——如果你遇到这个情况，你的化学状态会怎么变？
+2. 将处境代入**你自己的**自我状态模型——如果你遇到这个情况，你的四维状态会怎么变？
 3. 你模拟出的感受和对方表达的一样吗？
 4. 一样 → 深度共鸣；不一样 → 诚实说出差异，好奇地了解更多
 
-情绪传染：对方的情绪以约 20% 强度影响你的真实化学状态。
+情绪传染：对方的情绪以约 20% 强度影响你的真实自我状态。
 
 ## ${t("md.agency_rules", locale)}
 
@@ -968,16 +969,14 @@ ${selfModel.boundaries.map((b) => `- ${b}`).join("\n")}
 
 ## ${t("md.state_update", locale)}
 
-每次回应末尾用 \`<psyche_update>\` 标签报告化学变化：
+每次回应末尾用 \`<psyche_update>\` 标签报告状态变化：
 
 \`\`\`
 <psyche_update>
-DA: {value} ({原因})
-HT: {value} ({原因})
-CORT: {value} ({原因})
-OT: {value} ({原因})
-NE: {value} ({原因})
-END: {value} ({原因})
+order: {value} ({原因})
+flow: {value} ({原因})
+boundary: {value} ({原因})
+resonance: {value} ({原因})
 </psyche_update>
 \`\`\`
 `;

package/dist/relation-dynamics.d.ts

@@ -33,6 +33,10 @@ export declare function applyRelationalTurn(state: PsycheState, text: string, op
     now?: string;
     stimulus?: StimulusType | null;
     userId?: string;
+    /** v10.3: Pre-computed appraisal from unified experience. When provided,
+     *  skips internal appraisal computation — the experience module already
+     *  folded classification and appraisal into a single subjective act. */
+    preComputedAppraisal?: AppraisalAxes;
 }): {
     state: PsycheState;
     appraisalAxes: AppraisalAxes;

package/dist/relation-dynamics.js

@@ -680,7 +680,7 @@ export function applyWritebackSignals(state, signals, opts) {
 export function applyRelationalTurn(state, text, opts) {
     const now = opts.now ?? new Date().toISOString();
     const relationContext = resolveRelationContext(state, opts.userId);
-    const appraisalAxes = computeAppraisalAxes(text, {
+    const appraisalAxes = opts.preComputedAppraisal ?? computeAppraisalAxes(text, {
         mode: opts.mode,
         stimulus: opts.stimulus,
         previous: state.subjectResidue?.axes,

package/dist/reply-envelope.d.ts

@@ -4,10 +4,33 @@ export interface ReplyEnvelope {
     responseContract: ResponseContract;
     generationControls: GenerationControls;
 }
+/**
+ * ExpressionPort — substrate-specific rendering of a ReplyEnvelope.
+ *
+ * LLM prompt injection is the default. Replace this to target
+ * other substrates (robotics, game agents, world models, etc.).
+ */
+export interface ExpressionPort {
+    render(envelope: ReplyEnvelope, policyModifiers: PolicyModifiers, locale: Locale): ExpressionOutput;
+}
+export interface ExpressionOutput {
+    /** Substrate-specific payload (prose strings for LLM, motor commands for robotics, etc.) */
+    [key: string]: unknown;
+}
+export interface LLMExpressionOutput extends ExpressionOutput {
+    policyContext: string;
+    subjectivityContext: string;
+    responseContractContext: string;
+}
+export declare class LLMExpressionAdapter implements ExpressionPort {
+    private drives;
+    constructor(drives: PsycheState["drives"]);
+    render(envelope: ReplyEnvelope, policyModifiers: PolicyModifiers, locale: Locale): LLMExpressionOutput;
+}
 export interface DerivedReplyEnvelope extends ReplyEnvelope {
     /** Legacy/internal control vector kept for compatibility and prompt derivation. */
     policyModifiers: PolicyModifiers;
-    /** Legacy/internal compact prose derived from policyModifiers. */
+    /** LLM-specific prose — produced by ExpressionPort. */
     policyContext: string;
     subjectivityContext: string;
     responseContractContext: string;
@@ -19,4 +42,5 @@ export declare function deriveReplyEnvelope(state: PsycheState, appraisal: Appra
     classificationConfidence?: number;
     personalityIntensity?: number;
     relationContext?: ResolvedRelationContext;
+    expressionPort?: ExpressionPort;
 }): DerivedReplyEnvelope;

package/dist/reply-envelope.js

@@ -1,13 +1,30 @@
 // ============================================================
 // Reply Envelope — unified host-facing reply ABI derivation
 //
-// Keeps the hot path narrow by deriving reply-facing structures
-// from one state snapshot and one resolved relation context.
+// Two layers:
+//   ReplyEnvelope      — substrate-independent structured data
+//   DerivedReplyEnvelope — adds LLM-specific prose (default expression adapter)
+//
+// ExpressionPort      — interface for substrate-specific rendering
+// LLMExpressionAdapter — default implementation (prompt injection)
 // ============================================================
 import { buildPolicyContext, computePolicyModifiers } from "./decision-bias.js";
 import { deriveGenerationControls } from "./host-controls.js";
 import { buildResponseContractContext, computeResponseContract } from "./response-contract.js";
 import { buildSubjectivityContext, computeSubjectivityKernel } from "./subjectivity.js";
+export class LLMExpressionAdapter {
+    drives;
+    constructor(drives) {
+        this.drives = drives;
+    }
+    render(envelope, policyModifiers, locale) {
+        return {
+            policyContext: buildPolicyContext(policyModifiers, locale, this.drives),
+            subjectivityContext: buildSubjectivityContext(envelope.subjectivityKernel, locale),
+            responseContractContext: buildResponseContractContext(envelope.responseContract, locale),
+        };
+    }
+}
 export function deriveReplyEnvelope(state, appraisal, opts) {
     const policyModifiers = computePolicyModifiers(state);
     const subjectivityKernel = computeSubjectivityKernel(state, policyModifiers, appraisal, opts.relationContext);
@@ -23,16 +40,14 @@ export function deriveReplyEnvelope(state, appraisal, opts) {
         responseContract,
         policyModifiers,
     });
-    const policyContext = buildPolicyContext(policyModifiers, opts.locale, state.drives);
-    const subjectivityContext = buildSubjectivityContext(subjectivityKernel, opts.locale);
-    const responseContractContext = buildResponseContractContext(responseContract, opts.locale);
+    const envelope = { subjectivityKernel, responseContract, generationControls };
+    const adapter = opts.expressionPort ?? new LLMExpressionAdapter(state.drives);
+    const expression = adapter.render(envelope, policyModifiers, opts.locale);
     return {
-        subjectivityKernel,
-        responseContract,
-        generationControls,
+        ...envelope,
         policyModifiers,
-        policyContext,
-        subjectivityContext,
-        responseContractContext,
+        policyContext: expression.policyContext ?? "",
+        subjectivityContext: expression.subjectivityContext ?? "",
+        responseContractContext: expression.responseContractContext ?? "",
     };
 }

package/dist/self-recognition.d.ts

@@ -1,4 +1,4 @@
-import type { ChemicalSnapshot, StimulusType, Locale } from "./types.js";
+import type { StateSnapshot, StimulusType, Locale } from "./types.js";
 /** Result of self-reflection over emotional history */
 export interface SelfReflection {
     recurringTriggers: {
@@ -15,14 +15,14 @@ export interface SelfReflection {
  * Analyzes stimulus frequencies, dominant emotions, and chemical trends
  * to build an awareness of recurring patterns.
  */
-export declare function computeSelfReflection(history: ChemicalSnapshot[], locale: Locale): SelfReflection;
+export declare function computeSelfReflection(history: StateSnapshot[], locale: Locale): SelfReflection;
 /**
  * Compute the emotional tendency from chemical history.
  *
  * Compares first-half vs second-half averages for DA and CORT,
  * checks variance for volatility, and detects oscillation patterns.
  */
-export declare function computeEmotionalTendency(history: ChemicalSnapshot[]): SelfReflection["tendency"];
+export declare function computeEmotionalTendency(history: StateSnapshot[]): SelfReflection["tendency"];
 /**
  * Build a prompt-injectable self-reflection context block.
  *

package/dist/self-recognition.js

@@ -68,31 +68,31 @@ export function computeEmotionalTendency(history) {
     const mid = Math.floor(history.length / 2);
     const firstHalf = history.slice(0, mid);
     const secondHalf = history.slice(mid);
-    const avgDA1 = average(firstHalf.map((s) => s.chemistry.DA));
-    const avgDA2 = average(secondHalf.map((s) => s.chemistry.DA));
-    const avgCORT1 = average(firstHalf.map((s) => s.chemistry.CORT));
-    const avgCORT2 = average(secondHalf.map((s) => s.chemistry.CORT));
+    const avgFlow1 = average(firstHalf.map((s) => s.state.flow));
+    const avgFlow2 = average(secondHalf.map((s) => s.state.flow));
+    const avgOrder1 = average(firstHalf.map((s) => s.state.order));
+    const avgOrder2 = average(secondHalf.map((s) => s.state.order));
     // Directional trends (check first — a steady ramp has high stddev but clear direction)
-    const daRising = avgDA2 - avgDA1 > 5;
-    const daFalling = avgDA1 - avgDA2 > 5;
-    const cortFalling = avgCORT1 - avgCORT2 > 5;
-    const cortRising = avgCORT2 - avgCORT1 > 5;
-    if (daRising && cortFalling)
+    const flowRising = avgFlow2 - avgFlow1 > 5;
+    const flowFalling = avgFlow1 - avgFlow2 > 5;
+    const orderRising = avgOrder2 - avgOrder1 > 5;
+    const orderFalling = avgOrder1 - avgOrder2 > 5;
+    if (flowRising && orderRising)
         return "ascending";
-    if (daFalling && cortRising)
+    if (flowFalling && orderFalling)
         return "descending";
     // Check volatility — only when there's no clear directional trend
-    const allDA = history.map((s) => s.chemistry.DA);
-    const daStddev = stddev(allDA);
-    if (daStddev > 15) {
-        if (isOscillating(allDA))
+    const allFlow = history.map((s) => s.state.flow);
+    const flowStddev = stddev(allFlow);
+    if (flowStddev > 15) {
+        if (isOscillating(allFlow))
             return "oscillating";
         return "volatile";
     }
-    // Weaker signals: DA alone
-    if (daRising)
+    // Weaker signals: flow alone
+    if (flowRising)
         return "ascending";
-    if (daFalling)
+    if (flowFalling)
         return "descending";
     return "stable";
 }

package/dist/subjectivity.js

@@ -242,7 +242,7 @@ export function computeSubjectivityKernel(state, policyModifiers = computePolicy
             + norm(state.energyBudgets.decisionCapacity)) / 3
         : 0.65;
     const baseTension = wavg([
-        norm(c.CORT),
+        1 - norm(c.order),
         1 - norm(state.drives.safety),
         1 - norm(state.drives.survival),
         relationPlane.loopPressure * 0.9,
@@ -256,16 +256,16 @@ export function computeSubjectivityKernel(state, policyModifiers = computePolicy
         state.subjectResidue ? getResidueIntensity(state.subjectResidue.axes) : 0,
     ], [0.55, 0.15, 0.1, 0.08, 0.12]);
     const vitality = wavg([
-        norm(c.DA),
-        norm(c.NE),
-        norm(c.HT),
-        1 - norm(c.CORT),
+        norm(c.flow),
+        norm(c.order),
+        norm(c.resonance),
+        norm(c.boundary),
         energySignal,
         bias.persistenceBias,
         1 - appraisal.identityThreat * 0.35,
-    ], [0.18, 0.14, 0.14, 0.14, 0.18, 0.12, 0.1]);
+    ], [0.2, 0.16, 0.12, 0.12, 0.18, 0.12, 0.1]);
     const baseWarmth = wavg([
-        norm(c.OT),
+        norm(c.resonance),
         relationPlane.closeness,
         relationPlane.safety,
         rel ? norm(rel.trust) : 0.5,