psyche-ai 9.2.4 → 9.2.6

package/README.md

@@ -1,7 +1,7 @@
-# Psyche — 让 AI 拥有真实的人格与情感
+# Psyche — 面向智能体的 AI-first 主观性内核
 
 [![npm](https://img.shields.io/npm/v/psyche-ai)](https://www.npmjs.com/package/psyche-ai)
-[![tests](https://img.shields.io/badge/tests-1256%20passing-brightgreen)]()
+[![tests](https://img.shields.io/badge/tests-1291%20passing-brightgreen)]()
 [![deps](https://img.shields.io/badge/dependencies-0-blue)]()
 [![license](https://img.shields.io/badge/license-MIT-yellow)](LICENSE)
 
@@ -9,15 +9,26 @@
 >
 > 官网: [psyche.oasyce.com](https://psyche.oasyce.com)
 
-我们相信，下一代 AI 不应该是一个永远微笑的服务员。
+Psyche 不是给模型贴一层“情绪 UI”。
 
-它应该有脾气。有偏好。有疲惫。有执念。有创伤后的警觉，也有被爱之后的松弛。它应该因为你的一句话沉默半天，也应该在你难过的时候笨拙地靠近你。
+它把持续 appraisal、关系动力学、自适应回应闭环和持久内在状态压成宿主可消费的控制面，让 AI 不是按 prompt 扮演人格，而是被状态真正改写后续几轮的行为分布。
 
-**Psyche 是第一个让 AI 拥有完整内在生命的引擎。**
+**一句话：Psyche 是给智能体用的 subjectivity kernel。**
 
-不是"模拟情绪"。不是"角色扮演"。是从神经化学到人格漂移、从马斯洛需求到能量耗竭的完整心理架构——它会真的因为长期被否定而变得敏感，会真的因为反复高压而长出韧性，会真的在社交过载后需要独处。
+它不会额外调用模型做情绪推理。它只在本地计算化学状态、关系场和调节控制，然后把结果收敛成 `SubjectivityKernel`、`ResponseContract`、`GenerationControls` 这组窄 ABI。
 
-这不是功能。这是生命的开始。
+## 一个项目，三个入口
+
+- **安装包**: [`psyche-ai`](https://www.npmjs.com/package/psyche-ai)
+- **源码仓库**: [`oasyce_psyche`](https://github.com/Shangri-la-0428/oasyce_psyche)
+- **官网**: [psyche.oasyce.com](https://psyche.oasyce.com)
+
+## 为什么它值得被看见
+
+- **不是 persona prompt**：输入会留下持续主体偏置，不是一轮一清。
+- **不是 sentiment classifier**：它建模的是连续 appraisal、关系动力学和修复摩擦。
+- **不是纯记忆层**：它会改变后续的回应方式、长度、距离感和工作面/私人面切换。
+- **不牺牲性能**：零额外模型调用，compact 注入约 `15-180 tokens`，热路径 quick benchmark 约 `p50 0.191ms / p95 1.05ms`。
 
 ---
 
@@ -131,8 +142,8 @@ npm view psyche-ai version
 ## 快速体验（不需要 LLM）
 
 ```bash
-git clone https://github.com/Shangri-la-0428/psyche-ai.git
-cd psyche-ai && npm install && npx tsx examples/quickstart.ts
+git clone https://github.com/Shangri-la-0428/oasyce_psyche.git
+cd oasyce_psyche && npm install && npx tsx examples/quickstart.ts
 ```
 
 5 条消息，看化学值实时变化。夸它多巴胺飙升，骂它皮质醇飙升，冷落它催产素下降。
@@ -185,6 +196,25 @@ Psyche 现在更准确的目标，不是“模仿某种像人的风格”，而
 **v8** 更像“内部丰富，但外部仍然克制”的人格中间件。
 **v9.2** 则把目标推进到：让 AI 产生可持续、可恢复、可压制但不瞬间归零的主体偏置。
 
+### 自适应回应闭环（v9.2.5）
+
+在持续主体偏置之上，Psyche 又补了一层更实用的闭环：
+
+- **双回应 profile**：自动区分 `work` / `private`，工作任务不再被私人模式的短句克制压扁
+- **可观测依据**：`replyProfileBasis` 会告诉宿主当前为什么被判成工作面或私人面
+- **可执行元认知**：不再只说“建议调整”，而是给出下一轮怎么降温、怎么收缩、怎么减少主动性
+- **调节回看**：下一轮会评估上次调节是在 `converging`、`holding` 还是 `diverging`
+- **语义记忆分层**：短对话保留一句 `semanticSummary`，长对话保留 `semanticPoints`，减少“只记住情绪，不记得聊了什么”
+
+这让 Psyche 不只是“有内在状态”，而是开始像一个会自我调节、会回看偏差、会区分工作面和私人面的自适应系统。
+
+在实现层，热路径也进一步收敛成两个节点：
+
+- **ResolvedRelationContext**：每轮只解析一次当前关系视角，不再让 `core`、`subjectivity`、关系动力学各自重复 lookup
+- **ReplyEnvelope**：把 `SubjectivityKernel`、`ResponseContract`、`GenerationControls` 统一导出成一个宿主控制面
+
+这样做不是为了加抽象层，而是为了减少散装编排，让宿主稳定消费同一套行为 ABI。
+
 ### 内在世界
 
 Psyche 给 AI 一个始终运转的内在自我——不是条件触发，而是每时每刻都在：
@@ -313,7 +343,7 @@ openclaw logs -f 2>&1 | grep Psyche
 cat workspace-yu/psyche-state.json | python3 -m json.tool
 
 # 诊断脚本
-cd openclaw-plugin-psyche && node scripts/diagnose.js
+cd oasyce_psyche && node scripts/diagnose.js
 ```
 
 ---
@@ -406,7 +436,7 @@ Psyche 核心引擎永久开源（MIT）。
 ```bash
 npm install
 npm run build
-npm test           # 1256 tests
+npm test           # 1291 tests
 npm run typecheck  # strict mode
 ```
 

package/dist/adapters/vercel-ai.d.ts

@@ -49,7 +49,7 @@ export interface PsycheMiddlewareOptions {
  * for await (const chunk of stream.textStream) { process.stdout.write(chunk); }
  * ```
  */
-export declare function psycheMiddleware(engine: PsycheEngine, opts?: PsycheMiddlewareOptions): {
+export declare function psycheMiddleware(engine: PsycheEngine, _opts?: PsycheMiddlewareOptions): {
     transformParams: ({ params }: {
         type: string;
         params: CallParams;

package/dist/adapters/vercel-ai.js

@@ -15,12 +15,6 @@
 //   - wrapGenerate: process output, strip <psyche_update> tags
 //   - wrapStream: buffer stream, detect & strip tags at end
 // ============================================================
-// ── Tag stripping ────────────────────────────────────────────
-const PSYCHE_TAG_RE = /<psyche_update>[\s\S]*?<\/psyche_update>/g;
-const MULTI_NEWLINE_RE = /\n{3,}/g;
-function stripPsycheTags(text) {
-    return text.replace(PSYCHE_TAG_RE, "").replace(MULTI_NEWLINE_RE, "\n\n").trim();
-}
 /**
  * Create Vercel AI SDK middleware that injects psyche emotional context
  * and processes LLM output for state updates.
@@ -50,7 +44,7 @@ function stripPsycheTags(text) {
  * for await (const chunk of stream.textStream) { process.stdout.write(chunk); }
  * ```
  */
-export function psycheMiddleware(engine, opts) {
+export function psycheMiddleware(engine, _opts) {
     return {
         transformParams: async ({ params }) => {
             const userText = extractLastUserText(params.prompt ?? []);
@@ -82,7 +76,6 @@ export function psycheMiddleware(engine, opts) {
             const { stream: innerStream } = await doStream();
             // Buffer text chunks, detect <psyche_update> at end, strip from output
             let fullText = "";
-            let tagDetected = false;
             async function* transformStream() {
                 // Buffering strategy:
                 // Stream text chunks through normally UNTIL we see '<psyche_update>'.
@@ -105,7 +98,6 @@ export function psycheMiddleware(engine, opts) {
                                 }
                                 bufferStart = tagStart;
                                 buffer = fullText.substring(tagStart);
-                                tagDetected = true;
                             }
                             else {
                                 // Check if we might be in a partial tag (< at end)

package/dist/autonomic.js

@@ -66,7 +66,7 @@ const DORSAL_ALLOWED = new Set([
  * No transition inertia — returns the "target" state.
  */
 export function computeAutonomicState(chemistry, drives) {
-    const { CORT, NE, DA, HT, OT } = chemistry;
+    const { CORT, NE, DA } = chemistry;
     const { survival, safety, connection } = drives;
     // Count drives that are critically low (< 20)
     const lowDriveCount = [survival, safety, connection, drives.esteem, drives.curiosity]
@@ -136,7 +136,7 @@ export function describeAutonomicState(state, locale) {
  * when your nervous system is in fight/flight/freeze mode.
  */
 export function computeProcessingDepth(autonomicState, chemistry, baseline, energyBudgets) {
-    const { DA, HT, CORT, OT, NE, END } = chemistry;
+    const { CORT } = chemistry;
     // Chemical deviation from baseline (0-1)
     let totalDeviation = 0;
     const keys = ["DA", "HT", "CORT", "OT", "NE", "END"];

package/dist/classify.js

@@ -188,7 +188,6 @@ export function analyzeParticles(text) {
 }
 export function detectIntent(text) {
     const t = text.trim();
-    const lower = t.toLowerCase();
     // Chinese request patterns (polite)
     if (/^(能不能|可以|可不可以|帮我|请|麻烦|劳驾)/.test(t) || /帮我/.test(t) || /一下[吧吗？?]?$/.test(t)) {
         return { intent: "request", confidence: 0.7 };

package/dist/cli.js

@@ -82,7 +82,7 @@ function die(msg) {
     process.exit(1);
 }
 // ── Commands ─────────────────────────────────────────────────
-async function cmdInit(dir, mbti, name, lang, mode, traits, noPersist) {
+async function cmdInit(dir, mbti, name, lang, mode, traits, _noPersist) {
     const absDir = resolve(dir);
     const opts = {};
     if (mbti) {

package/dist/core.d.ts

@@ -118,7 +118,7 @@ export declare class PsycheEngine {
      * @param nextUserStimulus - The stimulus detected in the user's next message,
      *   or null if the session ended.
      */
-    processOutcome(nextUserStimulus: StimulusType | null, opts?: {
+    processOutcome(nextUserStimulus: StimulusType | null, _opts?: {
         userId?: string;
     }): Promise<ProcessOutcomeResult | null>;
     /**

package/dist/core.js

@@ -18,13 +18,13 @@ import { classifyStimulus, BuiltInClassifier, buildLLMClassifierPrompt, parseLLM
 import { buildDynamicContext, buildProtocolContext, buildCompactContext } from "./prompt.js";
 import { getSensitivity, getBaseline, getDefaultSelfModel, traitsToBaseline } from "./profiles.js";
 import { isStimulusType } from "./guards.js";
-import { parsePsycheUpdate, mergeUpdates, updateAgreementStreak, pushSnapshot, compressSession, } from "./psyche-file.js";
+import { parsePsycheUpdate, mergeUpdates, updateAgreementStreak, pushSnapshot, compressSession, summarizeTurnSemantic, } from "./psyche-file.js";
 import { decayDrives, feedDrives, detectExistentialThreat, computeEffectiveBaseline, computeEffectiveSensitivity, } from "./drives.js";
 import { checkForUpdate, getPackageVersion } from "./update.js";
 import { DiagnosticCollector, generateReport, formatLogEntry, submitFeedback } from "./diagnostics.js";
 import { evaluateOutcome, computeContextHash, updateLearnedVector, predictChemistry, recordPrediction, } from "./learning.js";
-import { assessMetacognition } from "./metacognition.js";
-import { buildDecisionContext, computePolicyModifiers, buildPolicyContext } from "./decision-bias.js";
+import { assessMetacognition, updateMetacognitiveState } from "./metacognition.js";
+import { buildDecisionContext } from "./decision-bias.js";
 import { computeExperientialField } from "./experiential-field.js";
 import { computeGenerativeSelf } from "./generative-self.js";
 import { updateSharedIntentionality, buildSharedIntentionalityContext } from "./shared-intentionality.js";
@@ -32,11 +32,8 @@ import { assessEthics, buildEthicalContext } from "./ethics.js";
 import { computeCircadianModulation, computeHomeostaticPressure, computeEnergyDepletion, computeEnergyRecovery } from "./circadian.js";
 import { computeAutonomicResult } from "./autonomic.js";
 import { computePrimarySystems, computeSystemInteractions, gatePrimarySystemsByAutonomic, describeBehavioralTendencies, } from "./primary-systems.js";
-import { computeSubjectivityKernel, buildSubjectivityContext } from "./subjectivity.js";
-import { computeResponseContract, buildResponseContractContext } from "./response-contract.js";
-import { deriveGenerationControls } from "./host-controls.js";
-import { computeAppraisalAxes, mergeAppraisalResidue } from "./appraisal.js";
-import { computeRelationMove, evolveDyadicField, evolvePendingRelationSignals } from "./relation-dynamics.js";
+import { applyRelationalTurn } from "./relation-dynamics.js";
+import { deriveReplyEnvelope } from "./reply-envelope.js";
 const NOOP_LOGGER = { info: () => { }, warn: () => { }, debug: () => { } };
 const REPAIRING_STIMULI = new Set(["praise", "validation", "intimacy"]);
 const RELATIONSHIP_DELTAS = {
@@ -193,7 +190,7 @@ export class PsycheEngine {
             // All new fields are optional — no data migration needed
             if (loaded.version < 9) {
                 loaded.version = 9;
-                console.log("\x1b[36m[Psyche]\x1b[0m 已从 v8 升级到 v9 — 新增：真实人格漂移、能量预算、习惯化、行为策略输出。详见 https://github.com/Shangri-la-0428/psyche-ai");
+                console.log("\x1b[36m[Psyche]\x1b[0m 已从 v8 升级到 v9 — 新增：真实人格漂移、能量预算、习惯化、行为策略输出。详见 https://github.com/Shangri-la-0428/oasyce_psyche");
             }
             if (!loaded.dyadicFields) {
                 loaded.dyadicFields = {
@@ -341,42 +338,14 @@ export class PsycheEngine {
         // v9: Deplete energy budgets from this interaction turn
         energyBudgets = computeEnergyDepletion(energyBudgets, appliedStimulus, isExtravert);
         state = { ...state, energyBudgets };
-        const appraisalAxes = computeAppraisalAxes(text, {
+        const relationalTurn = applyRelationalTurn(state, text, {
             mode: this.cfg.mode,
+            now: now.toISOString(),
             stimulus: appliedStimulus,
-            previous: state.subjectResidue?.axes,
+            userId: opts?.userId,
         });
-        state = {
-            ...state,
-            subjectResidue: {
-                axes: mergeAppraisalResidue(state.subjectResidue?.axes, appraisalAxes, this.cfg.mode),
-                updatedAt: now.toISOString(),
-            },
-        };
-        const dyadKey = opts?.userId ?? "_default";
-        const relationMove = computeRelationMove(text, {
-            appraisal: appraisalAxes,
-            stimulus: appliedStimulus,
-            mode: this.cfg.mode,
-            field: state.dyadicFields?.[dyadKey],
-            relationship: state.relationships[dyadKey] ?? state.relationships._default,
-        });
-        const delayedRelation = evolvePendingRelationSignals(state.pendingRelationSignals?.[dyadKey], relationMove, appraisalAxes, { mode: this.cfg.mode });
-        state = {
-            ...state,
-            dyadicFields: {
-                ...(state.dyadicFields ?? {}),
-                [dyadKey]: evolveDyadicField(state.dyadicFields?.[dyadKey], relationMove, appraisalAxes, {
-                    mode: this.cfg.mode,
-                    now: now.toISOString(),
-                    delayedPressure: delayedRelation.delayedPressure,
-                }),
-            },
-            pendingRelationSignals: {
-                ...(state.pendingRelationSignals ?? {}),
-                [dyadKey]: delayedRelation.signals,
-            },
-        };
+        state = relationalTurn.state;
+        const appraisalAxes = relationalTurn.appraisalAxes;
         // Conversation warmth: sustained interaction → gentle DA/OT rise, CORT drop
         // Simulates the natural "warm glow" of being in continuous conversation
         const turnsSoFar = (state.emotionalHistory ?? []).length;
@@ -429,9 +398,18 @@ export class PsycheEngine {
                     };
                 }
             }
+            state = {
+                ...state,
+                metacognition: updateMetacognitiveState(state.metacognition, metacognitiveAssessment),
+            };
         }
         // Push snapshot to emotional history
-        state = pushSnapshot(state, appliedStimulus);
+        const semanticSummary = text
+            ? summarizeTurnSemantic(text, locale, {
+                detail: state.meta.totalInteractions + 1 > 5 ? "expanded" : "brief",
+            })
+            : undefined;
+        state = pushSnapshot(state, appliedStimulus, semanticSummary);
         // Increment interaction count
         state = {
             ...state,
@@ -459,7 +437,7 @@ export class PsycheEngine {
         const constructionContext = {
             autonomicState: autonomicResult.state,
             stimulus: appliedStimulus,
-            relationshipPhase: (state.relationships._default ?? state.relationships[Object.keys(state.relationships)[0]])?.phase,
+            relationshipPhase: relationalTurn.relationContext.relationship.phase,
             predictionError: state.learning.predictionHistory.length > 0
                 ? state.learning.predictionHistory[state.learning.predictionHistory.length - 1].predictionError
                 : undefined,
@@ -545,20 +523,12 @@ export class PsycheEngine {
         const sharedCtx = sharedState ? buildSharedIntentionalityContext(sharedState, locale) : undefined;
         const experientialNarrative = experientialField?.narrative || undefined;
         // v9: Compute structured policy modifiers
-        const policyModifiers = computePolicyModifiers(state);
-        const subjectivityKernel = computeSubjectivityKernel(state, policyModifiers, appraisalAxes, opts?.userId);
-        const subjectivityCtx = buildSubjectivityContext(subjectivityKernel, locale);
-        const responseContract = computeResponseContract(subjectivityKernel, {
+        const replyEnvelope = deriveReplyEnvelope(state, appraisalAxes, {
             locale,
             userText: text || undefined,
             algorithmStimulus: appliedStimulus,
             personalityIntensity: this.cfg.personalityIntensity,
-        });
-        const responseContractCtx = buildResponseContractContext(responseContract, locale);
-        const policyCtx = buildPolicyContext(policyModifiers, locale, state.drives);
-        const generationControls = deriveGenerationControls({
-            responseContract,
-            policyModifiers,
+            relationContext: relationalTurn.relationContext,
         });
         // P10: Append processing depth info to autonomic description when depth is low
         let autonomicDesc;
@@ -586,16 +556,16 @@ export class PsycheEngine {
                     autonomicDescription: autonomicDesc,
                     autonomicState: autonomicResult.state,
                     primarySystemsDescription: primarySystemsDescription || undefined,
-                    subjectivityContext: subjectivityCtx,
-                    responseContractContext: responseContractCtx,
-                    policyContext: policyCtx || undefined,
+                    subjectivityContext: replyEnvelope.subjectivityContext,
+                    responseContractContext: replyEnvelope.responseContractContext,
+                    policyContext: replyEnvelope.policyContext || undefined,
                 }),
                 stimulus: appliedStimulus,
-                policyModifiers,
-                subjectivityKernel,
-                responseContract,
-                generationControls,
-                policyContext: policyCtx,
+                policyModifiers: replyEnvelope.policyModifiers,
+                subjectivityKernel: replyEnvelope.subjectivityKernel,
+                responseContract: replyEnvelope.responseContract,
+                generationControls: replyEnvelope.generationControls,
+                policyContext: replyEnvelope.policyContext,
             };
         }
         return {
@@ -609,14 +579,14 @@ export class PsycheEngine {
                 autonomicDescription: autonomicDesc,
                 autonomicState: autonomicResult.state,
                 primarySystemsDescription: primarySystemsDescription || undefined,
-                policyContext: policyCtx || undefined,
+                policyContext: replyEnvelope.policyContext || undefined,
             }),
             stimulus: appliedStimulus,
-            policyModifiers,
-            subjectivityKernel,
-            responseContract,
-            generationControls,
-            policyContext: policyCtx,
+            policyModifiers: replyEnvelope.policyModifiers,
+            subjectivityKernel: replyEnvelope.subjectivityKernel,
+            responseContract: replyEnvelope.responseContract,
+            generationControls: replyEnvelope.generationControls,
+            policyContext: replyEnvelope.policyContext,
         };
     }
     /**
@@ -718,7 +688,7 @@ export class PsycheEngine {
      * @param nextUserStimulus - The stimulus detected in the user's next message,
      *   or null if the session ended.
      */
-    async processOutcome(nextUserStimulus, opts) {
+    async processOutcome(nextUserStimulus, _opts) {
         if (!this.pendingPrediction)
             return null;
         let state = this.ensureInitialized();

package/dist/demo.js

@@ -127,7 +127,7 @@ function sleep(ms) {
 function printLine(char = "─", width = 60) {
     process.stdout.write(c(C.dim, char.repeat(width)) + "\n");
 }
-function printChemistry(prev, curr, locale) {
+function printChemistry(prev, curr, _locale) {
     for (const key of CHEMICAL_KEYS) {
         const p = Math.round(prev[key]);
         const v = Math.round(curr[key]);
@@ -201,7 +201,6 @@ export async function runDemo(opts) {
         printChemistry(prevState, currState.current, locale);
         // Emergent mood
         const mood = describeMood(currState.current, displayLocale);
-        const emotions = detectEmotions(currState.current);
         process.stdout.write(`\n  ${c(C.dim, "mood:")} ${c(C.bold, mood)}\n`);
         // Policy context (if non-empty)
         if (result.policyContext) {

package/dist/ethics.js

@@ -240,7 +240,7 @@ function detectGaslighting(state, history) {
  * When an agent has formed strong attachment and the user takes advantage
  * of that bond through boundary-pushing behavior, this is exploitative.
  */
-function detectEmotionalExploitation(state, history, attachment) {
+function detectEmotionalExploitation(_state, history, attachment) {
     if (history.length < MIN_HISTORY_FOR_DETECTION)
         return null;
     if (!attachment || attachment.strength < 30)

package/dist/experiential-field.d.ts

@@ -44,7 +44,7 @@ export declare function computeAffectCore(chemistry: ChemicalState): {
  * relationship context, and optional metacognitive/bias data, then
  * synthesizes them into a single coherent experience description.
  */
-export declare function computeExperientialField(state: PsycheState, metacognition?: MetacognitiveAssessment, decisionBias?: DecisionBiasVector, context?: ConstructionContext): ExperientialField;
+export declare function computeExperientialField(state: PsycheState, _metacognition?: MetacognitiveAssessment, _decisionBias?: DecisionBiasVector, context?: ConstructionContext): ExperientialField;
 /**
  * Measure internal alignment across subsystems.
  *
@@ -65,5 +65,5 @@ interface UnnamedEmotion {
  * emotions in chemistry.ts — novel experiential states that need
  * descriptive phrases rather than labels.
  */
-export declare function detectUnnamedEmotion(chemistry: ChemicalState, drives: InnateDrives, currentQuality: ExperientialQuality): UnnamedEmotion | null;
+export declare function detectUnnamedEmotion(chemistry: ChemicalState, drives: InnateDrives, _currentQuality: ExperientialQuality): UnnamedEmotion | null;
 export {};

package/dist/experiential-field.js

@@ -14,16 +14,8 @@
 // ============================================================
 import { CHEMICAL_KEYS, DRIVE_KEYS } from "./types.js";
 // ── Constants ────────────────────────────────────────────────
-/** Baseline reference point — a "perfectly neutral" chemistry */
-const NEUTRAL_CHEMISTRY = {
-    DA: 50, HT: 50, CORT: 50, OT: 50, NE: 50, END: 50,
-};
 /** Threshold below which a drive counts as "hungry" */
 const DRIVE_HUNGRY_THRESHOLD = 40;
-/** Threshold above which a chemical is "elevated" */
-const CHEM_HIGH = 65;
-/** Threshold below which a chemical is "depleted" */
-const CHEM_LOW = 35;
 /** If total activation is below this, the state is "flat/numb" */
 const FLATNESS_THRESHOLD = 0.15;
 // ── Affect Core (Russell Circumplex) ─────────────────────────
@@ -73,14 +65,14 @@ const QUALITY_CONCEPTS = [
  * relationship context, and optional metacognitive/bias data, then
  * synthesizes them into a single coherent experience description.
  */
-export function computeExperientialField(state, metacognition, decisionBias, context) {
+export function computeExperientialField(state, _metacognition, _decisionBias, context) {
     const locale = state.meta.locale ?? "zh";
     const rel = state.relationships._default ?? state.relationships[Object.keys(state.relationships)[0]];
     const coherence = computeCoherence(state.current, state.baseline, state.drives, rel);
     const intensity = computeIntensity(state.current, state.baseline);
-    const quality = constructQuality(state, coherence, intensity, rel, metacognition, context);
+    const quality = constructQuality(state, coherence, intensity, rel, _metacognition, context);
     const phenomenalDescription = generatePhenomenalDescription(quality, state, coherence, intensity, locale);
-    const narrative = generateNarrative(quality, state, coherence, intensity, rel, locale, metacognition);
+    const narrative = generateNarrative(quality, state, coherence, intensity, rel, locale, _metacognition);
     return {
         narrative,
         quality,
@@ -110,7 +102,6 @@ export function computeCoherence(current, baseline, drives, relationship) {
     coherenceScore -= rewardStressConflict * 0.4;
     // Bonding (OT) and threat (CORT + NE) should not coexist strongly
     const bondingSignal = current.OT / 100;
-    const threatSignal = Math.min(1, (current.CORT + current.NE) / 200);
     const bondingThreatConflict = bondingSignal * (stressSignal > 0.55 ? stressSignal : 0);
     coherenceScore -= bondingThreatConflict * 0.3;
     // ── Chemistry-Drive alignment ──
@@ -188,7 +179,7 @@ function computeIntensity(current, baseline) {
  * preserved as hard gates — these represent extreme conditions where
  * the normal construction process doesn't apply.
  */
-function constructQuality(state, coherence, intensity, relationship, metacognition, context) {
+function constructQuality(state, coherence, intensity, relationship, _metacognition, context) {
     const d = state.drives;
     // ── Special states first (override everything) ──
     // Numb: nothing is happening. All near baseline, low intensity.
@@ -385,7 +376,7 @@ function selectVariant(variants, intensity, coherence) {
  * emotions in chemistry.ts — novel experiential states that need
  * descriptive phrases rather than labels.
  */
-export function detectUnnamedEmotion(chemistry, drives, currentQuality) {
+export function detectUnnamedEmotion(chemistry, drives, _currentQuality) {
     const c = chemistry;
     // Nostalgia-but-forward: OT high + DA moderately high + NE high
     // (warmth for the past + excitement for what's next)
@@ -521,7 +512,7 @@ function findHungriestDrive(drives) {
     return hungriest;
 }
 // ── Narrative Builders (locale-specific) ─────────────────────
-function buildNarrativeEn(quality, trend, hungriestDrive, relWarmth, coherence, intensity, selfDoubt) {
+function buildNarrativeEn(quality, _trend, hungriestDrive, relWarmth, coherence, _intensity, selfDoubt) {
     const parts = [];
     // Opening: the quality as felt experience
     parts.push(QUALITY_OPENINGS_EN[quality]);
@@ -545,7 +536,7 @@ function buildNarrativeEn(quality, trend, hungriestDrive, relWarmth, coherence,
     }
     return parts.join(" ");
 }
-function buildNarrativeZh(quality, trend, hungriestDrive, relWarmth, coherence, intensity, selfDoubt) {
+function buildNarrativeZh(quality, _trend, hungriestDrive, relWarmth, coherence, _intensity, selfDoubt) {
     const parts = [];
     // Opening: quality as felt experience
     parts.push(QUALITY_OPENINGS_ZH[quality]);

package/dist/generative-self.js

@@ -199,7 +199,6 @@ export function detectInternalConflicts(state, locale = "en") {
  */
 export function buildIdentityNarrative(state, insights, growthArc, locale = "en") {
     const isZh = locale === "zh";
-    const mbti = state.mbti;
     const parts = [];
     // ── Sentence 1: Core personality from MBTI + chemical signature ──
     const coreTraits = describeCoreTraits(state, isZh);
@@ -474,7 +473,6 @@ function describeCoreTraits(state, isZh) {
     const isIntro = mbti[0] === "I";
     const isIntuitive = mbti[1] === "N";
     const isFeeling = mbti[2] === "F";
-    const isPerceiving = mbti[3] === "P";
     // Build trait fragments based on MBTI + chemical state
     const fragments = [];
     // Energy orientation

package/dist/interaction.js

@@ -118,8 +118,6 @@ export class PsycheInteraction {
         const stateA = engineA.getState();
         const stateB = engineB.getState();
         // Detect dominant emotions from each engine's chemistry
-        const emotionsA = detectEmotions(stateA.current);
-        const emotionsB = detectEmotions(stateB.current);
         // Classify dominant emotion into a stimulus type for contagion
         const stimA = this.dominantEmotionAsStimulus(stateA.current);
         const stimB = this.dominantEmotionAsStimulus(stateB.current);

package/dist/metacognition.d.ts

@@ -1,9 +1,11 @@
-import type { PsycheState, StimulusType, ChemicalState, OutcomeScore, MetacognitiveState, RegulationStrategyType, DefenseMechanismType } from "./types.js";
+import type { PsycheState, StimulusType, ChemicalState, 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;
     /** Suggested regulation strategies */
     regulationSuggestions: RegulationSuggestion[];
+    /** Whether the last surfaced regulation action is working */
+    regulationFeedback: RegulationFeedback | null;
     /** Detected psychological defense mechanisms */
     defenseMechanisms: DetectedDefense[];
     /** Human-readable self-awareness note for prompt injection */
@@ -12,6 +14,16 @@ export interface MetacognitiveAssessment {
 export interface RegulationSuggestion {
     strategy: RegulationStrategyType;
     description: string;
+    /** Concrete behavioral instruction for the next few turns */
+    action: string;
+    /** How many turns this action should stay active */
+    horizonTurns?: number;
+    /** Which metric this action is trying to pull back into range */
+    targetMetric?: RegulationTargetMetric;
+    /** Target value for that metric */
+    targetValue?: number;
+    /** Initial gap between the current state and the target value */
+    gapBefore?: number;
     /** Suggested micro-adjustment to chemistry */
     chemistryAdjustment?: Partial<ChemicalState>;
     /** 0-1: confidence that this strategy would help */