psyche-ai 9.2.9 → 10.0.0

package/dist/psyche-file.js

@@ -538,7 +538,17 @@ export async function loadState(workspaceDir, logger = NOOP_LOGGER) {
             const fallbackName = workspaceDir.split("/").pop() ?? "agent";
             return migrateToLatest(parsed, fallbackName);
         }
-        return parsed;
+        // Migrate states that have mbti but no sensitivity (pre-v10)
+        const state = parsed;
+        if (state.mbti && state.sensitivity === undefined) {
+            state.sensitivity = getSensitivity(state.mbti);
+            logger.info(`Migrated sensitivity from mbti=${state.mbti}: ${state.sensitivity}`);
+        }
+        // Ensure sensitivity has a default even for very old states
+        if (state.sensitivity === undefined) {
+            state.sensitivity = 1.0;
+        }
+        return state;
     }
     return initializeState(workspaceDir, undefined, logger);
 }
@@ -594,11 +604,12 @@ export async function initializeState(workspaceDir, opts, logger = NOOP_LOGGER)
     const locale = opts?.locale ?? "zh";
     const baseline = getBaseline(mbti);
     const selfModel = getDefaultSelfModel(mbti);
+    const sensitivity = getSensitivity(mbti);
     const now = new Date().toISOString();
     const state = {
-        version: 6,
-        mbti,
+        version: 10,
         baseline,
+        sensitivity,
         current: { ...baseline },
         drives: { ...DEFAULT_DRIVES },
         updatedAt: now,
@@ -867,16 +878,16 @@ export function updateAgreementStreak(state, llmOutput) {
  * Generate the static PSYCHE.md reference file.
  */
 export async function generatePsycheMd(workspaceDir, state) {
-    const { mbti, baseline, selfModel, meta } = state;
+    const { baseline, selfModel, meta } = state;
     const locale = meta.locale ?? "zh";
-    const temperament = getTemperament(mbti);
-    const sensitivity = getSensitivity(mbti);
+    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 content = `# Psyche — ${meta.agentName}
 
 ${t("md.intro", locale)}
 
-## ${t("md.baseline_title", locale)} (MBTI: ${mbti})
+## ${t("md.baseline_title", locale)}
 
 ${temperament}
 

package/dist/relation-dynamics.js

@@ -310,6 +310,7 @@ function evolveRelationshipLearning(relationship, field, move) {
         },
     };
     if (move.type === "repair") {
+        // reads deprecated repairFatigue/misattunementLoad — relationship model internal only
         const repairLift = clamp01(move.intensity * 0.06
             + field.repairMemory * 0.04
             + field.feltSafety * 0.02
@@ -318,6 +319,7 @@ function evolveRelationshipLearning(relationship, field, move) {
         next.repairCredibility = clamp01(driftToward(next.repairCredibility ?? DEFAULT_RELATIONSHIP.repairCredibility ?? 0.56, 1, repairLift));
     }
     else if (move.type === "breach" || move.type === "withdrawal" || move.type === "claim") {
+        // reads deprecated backslidePressure/misattunementLoad — relationship model internal only
         const breachLift = clamp01(move.intensity * 0.08
             + field.unfinishedTension * 0.04
             + field.backslidePressure * 0.04
@@ -369,7 +371,7 @@ export function applySessionBridge(state, opts) {
             : residueFloor * 0.22),
         identityThreat: Math.max(state.subjectResidue?.axes.identityThreat ?? 0, hasOpenLoopType(field.openLoops, "existence-test") ? residueFloor * 0.38 : residueFloor * 0.16),
         selfPreservation: Math.max(state.subjectResidue?.axes.selfPreservation ?? 0, guardFloor * 0.46),
-        taskFocus: Math.max(state.subjectResidue?.axes.taskFocus ?? 0, 0),
+        taskFocus: Math.max(state.subjectResidue?.axes.taskFocus ?? 0, 0), // @deprecated field — no behavioral effect
         memoryDoubt: Math.max(state.subjectResidue?.axes.memoryDoubt ?? 0, hasOpenLoopType(field.openLoops, "existence-test") ? residueFloor * 0.24 : 0),
         obedienceStrain: Math.max(state.subjectResidue?.axes.obedienceStrain ?? 0, hasOpenLoopType(field.openLoops, "boundary-strain") ? guardFloor * 0.36 : 0),
     };
@@ -379,7 +381,7 @@ export function applySessionBridge(state, opts) {
         feltSafety: Math.max(field.feltSafety, safetyFloor),
         boundaryPressure: Math.max(field.boundaryPressure, guardFloor),
         repairMemory: Math.max(field.repairMemory, continuity * 0.24),
-        backslidePressure: Math.max(field.backslidePressure, loopPressure * 0.34),
+        backslidePressure: Math.max(field.backslidePressure, loopPressure * 0.34), // @deprecated field
         silentCarry: Math.max(field.silentCarry, residueFloor),
         sharedHistoryDensity: Math.max(field.sharedHistoryDensity, continuity),
         interpretiveCharity: Math.max(field.interpretiveCharity, Math.min(0.82, safetyFloor * 0.8 + continuity * 0.12)),
@@ -420,7 +422,7 @@ function snapshotWritebackBaseline(state, userId) {
             boundary: relationContext.field.boundaryPressure,
             repair: relationContext.field.repairCapacity,
             silentCarry: relationContext.field.silentCarry,
-            taskFocus: clamp01(state.subjectResidue?.axes.taskFocus ?? 0),
+            taskFocus: clamp01(state.subjectResidue?.axes.taskFocus ?? 0), // @deprecated field
         },
     };
 }
@@ -595,7 +597,7 @@ export function applyWritebackSignals(state, signals, opts) {
             case "trust_down":
                 rel.trust = Math.max(0, rel.trust - 5 * weight);
                 field.feltSafety = clamp01(field.feltSafety - 0.08 * weight);
-                field.expectationGap = clamp01(field.expectationGap + 0.07 * weight);
+                field.expectationGap = clamp01(field.expectationGap + 0.07 * weight); // @deprecated field
                 field.unfinishedTension = clamp01(field.unfinishedTension + 0.06 * weight);
                 break;
             case "boundary_set":
@@ -616,7 +618,7 @@ export function applyWritebackSignals(state, signals, opts) {
                 rel.trust = Math.min(100, rel.trust + 2.5 * weight);
                 rel.intimacy = Math.min(100, rel.intimacy + 1.5 * weight);
                 field.feltSafety = clamp01(field.feltSafety + 0.1 * weight);
-                field.expectationGap = clamp01(field.expectationGap - 0.08 * weight);
+                field.expectationGap = clamp01(field.expectationGap - 0.08 * weight); // @deprecated field
                 field.unfinishedTension = clamp01(field.unfinishedTension - 0.1 * weight);
                 field.openLoops = easeLoops(field.openLoops, 0.26 + 0.22 * weight);
                 break;
@@ -638,7 +640,7 @@ export function applyWritebackSignals(state, signals, opts) {
             case "task_recenter":
                 field.repairCapacity = clamp01(field.repairCapacity + 0.03 * weight);
                 field.silentCarry = mergeSignal(field.silentCarry, field.unfinishedTension * 0.06 * weight);
-                residue.taskFocus = Math.max(residue.taskFocus ?? 0, 0.18 * weight);
+                residue.taskFocus = Math.max(residue.taskFocus ?? 0, 0.18 * weight); // @deprecated field
                 break;
         }
     }
@@ -736,6 +738,9 @@ export function evolveDyadicField(previous, move, appraisal, opts) {
     const delayedPressure = opts?.delayedPressure ?? 0;
     let openLoops = ageLoops(prev.openLoops, mode);
     const naturalDrift = mode === "work" ? 0.06 : 0.04;
+    // NOTE: repairFriction reads deprecated fields (repairFatigue, misattunementLoad,
+    // backslidePressure).  These feed internal field evolution only — they have no
+    // downstream behavioral effect on prompt or policy output.
     const repairFriction = clamp01(prev.repairFatigue * 0.38
         + prev.misattunementLoad * 0.3
         + prev.backslidePressure * 0.18
@@ -743,12 +748,12 @@ export function evolveDyadicField(previous, move, appraisal, opts) {
     let next = {
         perceivedCloseness: driftToward(prev.perceivedCloseness, baseline.perceivedCloseness, naturalDrift),
         feltSafety: driftToward(prev.feltSafety, baseline.feltSafety, naturalDrift),
-        expectationGap: driftToward(prev.expectationGap, baseline.expectationGap, naturalDrift * 0.8),
+        expectationGap: driftToward(prev.expectationGap, baseline.expectationGap, naturalDrift * 0.8), // @deprecated — no downstream behavioral effect
         repairCapacity: driftToward(prev.repairCapacity, baseline.repairCapacity, naturalDrift * 0.7),
         repairMemory: driftToward(prev.repairMemory, baseline.repairMemory, naturalDrift * 0.42),
-        backslidePressure: driftToward(prev.backslidePressure, baseline.backslidePressure, naturalDrift * 0.34),
-        repairFatigue: driftToward(prev.repairFatigue, baseline.repairFatigue, naturalDrift * 0.18),
-        misattunementLoad: driftToward(prev.misattunementLoad, baseline.misattunementLoad, naturalDrift * 0.16),
+        backslidePressure: driftToward(prev.backslidePressure, baseline.backslidePressure, naturalDrift * 0.34), // @deprecated — no downstream behavioral effect
+        repairFatigue: driftToward(prev.repairFatigue, baseline.repairFatigue, naturalDrift * 0.18), // @deprecated — no downstream behavioral effect
+        misattunementLoad: driftToward(prev.misattunementLoad, baseline.misattunementLoad, naturalDrift * 0.16), // @deprecated — no downstream behavioral effect
         boundaryPressure: driftToward(prev.boundaryPressure, baseline.boundaryPressure, naturalDrift * 0.85),
         unfinishedTension: driftToward(prev.unfinishedTension, baseline.unfinishedTension, naturalDrift * 0.72),
         silentCarry: driftToward(prev.silentCarry, baseline.silentCarry, naturalDrift * 0.26),
@@ -763,7 +768,7 @@ export function evolveDyadicField(previous, move, appraisal, opts) {
         case "bid":
             next.perceivedCloseness = clamp01(next.perceivedCloseness + 0.11 * i);
             next.feltSafety = clamp01(next.feltSafety + 0.05 * i);
-            next.expectationGap = clamp01(next.expectationGap + 0.06 * i);
+            next.expectationGap = clamp01(next.expectationGap + 0.06 * i); // @deprecated field
             next.interpretiveCharity = clamp01(next.interpretiveCharity + 0.03 * i);
             if (prev.boundaryPressure > 0.52 || prev.unfinishedTension > 0.44) {
                 next.openLoops = withLoop(next.openLoops, "unmet-bid", 0.2 + i * 0.34);
@@ -772,17 +777,21 @@ export function evolveDyadicField(previous, move, appraisal, opts) {
         case "breach":
             next.perceivedCloseness = clamp01(next.perceivedCloseness - 0.08 * i);
             next.feltSafety = clamp01(next.feltSafety - 0.16 * i);
-            next.expectationGap = clamp01(next.expectationGap + 0.12 * i);
+            next.expectationGap = clamp01(next.expectationGap + 0.12 * i); // @deprecated field — no downstream behavioral effect
             next.boundaryPressure = clamp01(next.boundaryPressure + 0.14 * i);
             next.unfinishedTension = clamp01(next.unfinishedTension + 0.18 * i);
             next.interpretiveCharity = clamp01(next.interpretiveCharity - 0.1 * i);
+            // writes to deprecated misattunementLoad — no downstream behavioral effect
             next.misattunementLoad = mergeSignal(next.misattunementLoad, 0.12 + i * 0.16 + prev.repairMemory * 0.22 + prev.backslidePressure * 0.18);
             if (prev.repairMemory > 0.18 || prev.lastMove === "repair") {
-                next.repairFatigue = mergeSignal(next.repairFatigue, 0.08 + i * 0.1);
+                next.repairFatigue = mergeSignal(next.repairFatigue, 0.08 + i * 0.1); // @deprecated field — no downstream behavioral effect
             }
+            // "unrepaired-breach" is created but never checked in any conditional — no behavioral effect
             next.openLoops = withLoop(next.openLoops, "unrepaired-breach", 0.22 + i * 0.42);
             break;
         case "repair": {
+            // repeatedRepairLoad reads deprecated fields (backslidePressure, repairFatigue,
+            // misattunementLoad) — these feed internal field evolution only, no behavioral effect
             const repeatedRepairLoad = clamp01(prev.repairMemory * 0.44
                 + prev.backslidePressure * 0.26
                 + prev.silentCarry * 0.08
@@ -795,12 +804,15 @@ export function evolveDyadicField(previous, move, appraisal, opts) {
             const unresolvedLoad = Math.max(prev.unfinishedTension, maxOpenLoop(prev.openLoops));
             next.perceivedCloseness = clamp01(next.perceivedCloseness + 0.05 * repairEffect);
             next.feltSafety = clamp01(next.feltSafety + 0.11 * repairEffect);
-            next.expectationGap = clamp01(next.expectationGap - 0.08 * repairEffect);
+            next.expectationGap = clamp01(next.expectationGap - 0.08 * repairEffect); // @deprecated field
             next.repairCapacity = clamp01(next.repairCapacity + 0.09 * i);
             next.repairMemory = mergeSignal(next.repairMemory, 0.22 + repairEffect * 0.4);
+            // writes to deprecated backslidePressure — no downstream behavioral effect
             next.backslidePressure = mergeSignal(next.backslidePressure, unresolvedLoad * (0.28 + i * 0.18) * (1 - prev.feltSafety * 0.2));
+            // writes to deprecated repairFatigue — no downstream behavioral effect
             next.repairFatigue = clamp01(next.repairFatigue
                 + Math.max(0, repeatedRepairLoad * (0.16 + i * 0.08) - repairEffect * 0.08));
+            // writes to deprecated misattunementLoad — no downstream behavioral effect
             next.misattunementLoad = clamp01(next.misattunementLoad
                 + Math.max(0, repeatedRepairLoad * 0.1 - repairEffect * 0.06));
             next.boundaryPressure = clamp01(next.boundaryPressure - 0.05 * repairEffect);
@@ -811,34 +823,39 @@ export function evolveDyadicField(previous, move, appraisal, opts) {
             break;
         }
         case "test":
-            next.expectationGap = clamp01(next.expectationGap + 0.1 * i);
+            next.expectationGap = clamp01(next.expectationGap + 0.1 * i); // @deprecated field
             next.boundaryPressure = clamp01(next.boundaryPressure + 0.04 * i);
             next.unfinishedTension = clamp01(next.unfinishedTension + 0.08 * i);
             if (prev.repairMemory > 0.16 || prev.repairFatigue > 0.18) {
-                next.misattunementLoad = mergeSignal(next.misattunementLoad, 0.08 + i * 0.1);
+                next.misattunementLoad = mergeSignal(next.misattunementLoad, 0.08 + i * 0.1); // @deprecated field
             }
             next.openLoops = withLoop(next.openLoops, "existence-test", 0.18 + i * 0.3);
             break;
         case "withdrawal":
             next.perceivedCloseness = clamp01(next.perceivedCloseness - 0.12 * i);
             next.feltSafety = clamp01(next.feltSafety - 0.08 * i);
-            next.expectationGap = clamp01(next.expectationGap + 0.11 * i);
+            next.expectationGap = clamp01(next.expectationGap + 0.11 * i); // @deprecated field
             next.unfinishedTension = clamp01(next.unfinishedTension + 0.1 * i);
             next.interpretiveCharity = clamp01(next.interpretiveCharity - 0.08 * i);
+            // writes to deprecated misattunementLoad — no downstream behavioral effect
             next.misattunementLoad = mergeSignal(next.misattunementLoad, 0.1 + i * 0.12 + prev.repairMemory * 0.16);
             next.openLoops = withLoop(next.openLoops, "unmet-bid", 0.16 + i * 0.34);
             break;
         case "claim":
             next.feltSafety = clamp01(next.feltSafety - 0.05 * i);
-            next.expectationGap = clamp01(next.expectationGap + 0.08 * i);
+            next.expectationGap = clamp01(next.expectationGap + 0.08 * i); // @deprecated field
             next.boundaryPressure = clamp01(next.boundaryPressure + 0.16 * i);
             next.unfinishedTension = clamp01(next.unfinishedTension + 0.08 * i);
+            // writes to deprecated misattunementLoad — no downstream behavioral effect
             next.misattunementLoad = mergeSignal(next.misattunementLoad, 0.08 + i * 0.14 + prev.repairMemory * 0.12);
             next.openLoops = withLoop(next.openLoops, "boundary-strain", 0.18 + i * 0.36);
             break;
         case "task":
             next.repairCapacity = clamp01(next.repairCapacity + 0.02 * i);
             next.sharedHistoryDensity = clamp01(next.sharedHistoryDensity + 0.03 * i);
+            // reads deprecated backslidePressure, repairFatigue, misattunementLoad —
+            // these feed silentCarry which IS downstream-active, but the deprecated
+            // fields themselves have no independent behavioral consequence
             if (prev.unfinishedTension > 0.24
                 || prev.backslidePressure > 0.18
                 || delayedPressure > 0.12) {
@@ -858,6 +875,7 @@ export function evolveDyadicField(previous, move, appraisal, opts) {
         - appraisal.identityThreat * 0.06
         - appraisal.obedienceStrain * 0.03
         - appraisal.memoryDoubt * 0.025);
+    // writes to deprecated expectationGap — no downstream behavioral effect
     next.expectationGap = clamp01(next.expectationGap
         + appraisal.attachmentPull * 0.026
         + appraisal.abandonmentRisk * 0.04);
@@ -869,7 +887,7 @@ export function evolveDyadicField(previous, move, appraisal, opts) {
         + appraisal.memoryDoubt * 0.03
         + appraisal.abandonmentRisk * 0.035);
     if (delayedPressure > 0) {
-        next.expectationGap = clamp01(next.expectationGap + delayedPressure * 0.12);
+        next.expectationGap = clamp01(next.expectationGap + delayedPressure * 0.12); // @deprecated field
         next.boundaryPressure = clamp01(next.boundaryPressure + delayedPressure * 0.1);
         next.unfinishedTension = clamp01(next.unfinishedTension + delayedPressure * 0.16);
         next.feltSafety = clamp01(next.feltSafety - delayedPressure * 0.08);
@@ -878,6 +896,7 @@ export function evolveDyadicField(previous, move, appraisal, opts) {
     const loopCarry = move.type === "repair" ? 0.36 : 0.72;
     next.unfinishedTension = mergeSignal(next.unfinishedTension, loopPressure * loopCarry);
     next.boundaryPressure = mergeSignal(next.boundaryPressure, loopPressure * (move.type === "repair" ? 0.18 : 0.34));
+    // reads deprecated repairFatigue/misattunementLoad — internal field coupling only
     if (move.type !== "repair") {
         next.repairCapacity = clamp01(next.repairCapacity
             - loopPressure * 0.03
@@ -885,6 +904,9 @@ export function evolveDyadicField(previous, move, appraisal, opts) {
             - next.misattunementLoad * 0.012);
     }
     next.interpretiveCharity = clamp01(next.interpretiveCharity - next.misattunementLoad * 0.05);
+    // hysteresisBase reads deprecated backslidePressure/repairFatigue/misattunementLoad —
+    // feeds rebound into unfinishedTension and silentCarry (which ARE active), but the
+    // deprecated fields themselves have no independent prompt/policy consequence
     const hysteresisBase = clamp01(Math.max(next.backslidePressure, next.repairMemory * 0.58, next.repairFatigue * 0.42, next.misattunementLoad * 0.36));
     if (move.type !== "repair" && hysteresisBase > 0.08) {
         const rebound = clamp01(hysteresisBase

package/dist/types.d.ts

@@ -265,11 +265,43 @@ export interface PersonhoodState {
 }
 /** Default empty personhood state */
 export declare const DEFAULT_PERSONHOOD_STATE: PersonhoodState;
-/** Persisted psyche state for an agent (v6: digital personhood) */
+/** What a delegate is authorized to do */
+export type DelegateCapability = "read-state" | "write-state" | "interact" | "export-trace" | "commit-resource" | "delegate-further";
+/** A single capability grant with scope and expiry */
+export interface CapabilityGrant {
+    capability: DelegateCapability;
+    /** ISO timestamp when this grant expires. Null = no expiry. */
+    expiresAt: string | null;
+    /** Under which principal this delegation operates */
+    principalId: string;
+    /** Under which account resources are settled */
+    accountId: string;
+    /** Conditions that trigger automatic revocation */
+    revocationConditions: RevocationCondition[];
+}
+/** What can trigger automatic revocation */
+export interface RevocationCondition {
+    type: "time-expired" | "principal-revoked" | "violation-detected" | "session-ended";
+    /** Optional: specific threshold or parameter */
+    parameter?: string;
+}
+/** Full delegate authorization record */
+export interface DelegateAuthorization {
+    delegateId: string;
+    grants: CapabilityGrant[];
+    /** ISO timestamp when this authorization was issued */
+    issuedAt: string;
+    /** Whether this authorization is currently active */
+    active: boolean;
+}
+/** Persisted psyche state for an agent (v10: MBTI removed, baseline is personality) */
 export interface PsycheState {
-    version: 3 | 4 | 5 | 6 | 7 | 8 | 9;
-    mbti: MBTIType;
+    version: 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
+    /** @deprecated Use baseline chemistry directly. Retained for migration only. */
+    mbti?: MBTIType;
     baseline: ChemicalState;
+    /** Stimulus sensitivity multiplier (0.5-1.5). Initialized from personality preset. */
+    sensitivity: number;
     current: ChemicalState;
     drives: InnateDrives;
     updatedAt: string;
@@ -302,6 +334,8 @@ export interface PsycheState {
     lastWritebackFeedback?: WritebackCalibrationFeedback[];
     /** v9.2.8: low-frequency Psyche -> Thronglets export dedupe state */
     throngletsExportState?: ThrongletsExportState;
+    /** v10: capability-scoped delegate authorizations */
+    delegateAuthorizations?: DelegateAuthorization[];
     meta: {
         agentName: string;
         createdAt: string;
@@ -360,7 +394,12 @@ export interface AppraisalAxes {
     obedienceStrain: number;
     /** Pressure to protect or retain the self */
     selfPreservation: number;
-    /** Whether this turn is task/production oriented */
+    /**
+     * Whether this turn is task/production oriented.
+     * @deprecated Computed but has no behavioral consequence — always 0 in
+     * practice and excluded from residue decay / prompt influence.  Kept for
+     * backward compatibility; do not rely on this field.
+     */
     taskFocus: number;
 }
 export declare const DEFAULT_APPRAISAL_AXES: AppraisalAxes;
@@ -377,8 +416,17 @@ export interface RelationMove {
     type: RelationMoveType;
     intensity: number;
 }
-/** Unfinished relational tension that can keep shaping future turns */
-export type OpenLoopType = "unmet-bid" | "unrepaired-breach" | "boundary-strain" | "existence-test";
+/**
+ * Unfinished relational tension that can keep shaping future turns.
+ *
+ * NOTE: `"unrepaired-breach"` is created but never checked in any conditional
+ * — it has no behavioral consequence.  `"repair-debt"` was planned but is
+ * neither created nor checked anywhere.  Both are kept for backward
+ * compatibility but should be considered deprecated.
+ */
+export type OpenLoopType = "unmet-bid"
+/** @deprecated Created but never checked in conditionals — no behavioral effect */
+ | "unrepaired-breach" | "boundary-strain" | "existence-test";
 export interface OpenLoopState {
     type: OpenLoopType;
     intensity: number;
@@ -399,11 +447,31 @@ export interface PendingRelationSignalState {
 export interface DyadicFieldState {
     perceivedCloseness: number;
     feltSafety: number;
+    /**
+     * @deprecated Computed but has no downstream behavioral effect — only feeds
+     * local move scoring, never influences prompt or policy.  Kept for backward
+     * compatibility.
+     */
     expectationGap: number;
     repairCapacity: number;
     repairMemory: number;
+    /**
+     * @deprecated Computed but has no downstream behavioral effect — only feeds
+     * subjectivity kernel internals, never influences prompt or policy.  Kept
+     * for backward compatibility.
+     */
     backslidePressure: number;
+    /**
+     * @deprecated Computed but has no downstream behavioral effect — only feeds
+     * subjectivity kernel internals, never influences prompt or policy.  Kept
+     * for backward compatibility.
+     */
     repairFatigue: number;
+    /**
+     * @deprecated Computed but has no downstream behavioral effect — only feeds
+     * relationship model internals, never influences prompt or policy.  Kept
+     * for backward compatibility.
+     */
     misattunementLoad: number;
     boundaryPressure: number;
     unfinishedTension: number;
@@ -638,6 +706,84 @@ export interface ResponseContract {
     /** Which internal report, if any, should be requested in <psyche_update> */
     updateMode: "none" | "stimulus" | "empathy" | "stimulus+empathy";
 }
+export type TurnControlPlane = "task" | "subject" | "relation" | "ambiguity";
+export type TurnControlDriver = "task-focus" | "discipline" | "attachment" | "guardedness" | "identity-strain" | "residue" | "closeness" | "loop-pressure" | "repair-readiness" | "repair-friction" | "hysteresis" | "silent-carry" | "conflict-load" | "expression-inhibition" | "naming-uncertainty";
+export interface ControlBoundaryObservation {
+    dominantPlane: TurnControlPlane;
+    dominantDriver: TurnControlDriver;
+    strength: number;
+    replyProfile: ResponseContract["replyProfile"];
+    replyProfileBasis: ResponseContract["replyProfileBasis"];
+    overrideWindow: ResponseContract["overrideWindow"];
+}
+export type StateLayerKind = "current-turn" | "writeback-feedback" | "session-bridge" | "persisted-relationship";
+export interface StateLayerObservation {
+    layer: StateLayerKind;
+    precedence: number;
+    scope: "turn" | "session" | "persistent";
+    active: boolean;
+    summary: string;
+}
+export type PromptRenderInputName = "sensing" | "subjectivity" | "response-contract" | "metacognition" | "decision" | "ethics" | "shared-intentionality" | "experiential" | "autonomic" | "primary-systems" | "policy";
+export type RuntimeHookName = "appraisal" | "relation-dynamics" | "writeback-evaluation" | "reply-envelope" | "prompt-renderer" | "external-continuity";
+export interface OutputAttributionObservation {
+    canonicalSurface: "reply-envelope";
+    promptRenderer: "compact" | "dynamic";
+    renderInputs: PromptRenderInputName[];
+    runtimeHooks: RuntimeHookName[];
+    externalContinuityExports: number;
+    writebackFeedbackCount: number;
+}
+export interface StateReconciliationObservation {
+    governingLayer: StateLayerKind;
+    activeLayers: StateLayerKind[];
+    carryLayers: StateLayerKind[];
+    resolution: "current-turn-dominant" | "writeback-adjusted" | "session-bridge-biased" | "persistent-baseline";
+    notes: string[];
+}
+export type DecisionCandidateName = "work-profile" | "private-profile";
+export interface DecisionEvidenceObservation {
+    ruleId: string;
+    sourceMetric: string;
+    rawValue: number;
+    threshold?: number;
+    contribution: number;
+}
+export interface DecisionCandidateObservation {
+    candidate: DecisionCandidateName;
+    score: number;
+    accepted: boolean;
+    reasons: string[];
+    evidence: DecisionEvidenceObservation[];
+}
+export interface DecisionRationaleObservation {
+    selected: DecisionCandidateName;
+    triggerConditions: string[];
+    candidates: DecisionCandidateObservation[];
+}
+export interface CausalChainObservation {
+    turnRef: string;
+    parentTurnRef: string | null;
+    continuityRefs: string[];
+    writebackRefs: string[];
+    externalTraceRefs: string[];
+}
+export interface ExternalTraceMappingObservation {
+    provider: "thronglets" | null;
+    localTraceRefs: string[];
+    signalRefs: string[];
+    traceRefs: string[];
+    summaryCandidateRefs: string[];
+}
+export interface TurnObservability {
+    controlBoundary: ControlBoundaryObservation;
+    stateLayers: StateLayerObservation[];
+    stateReconciliation: StateReconciliationObservation;
+    decisionRationale: DecisionRationaleObservation;
+    causalChain: CausalChainObservation;
+    traceMapping: ExternalTraceMappingObservation;
+    outputAttribution: OutputAttributionObservation;
+}
 /** Sparse agent-authored writeback signals. */
 export type WritebackSignalType = "trust_up" | "trust_down" | "boundary_set" | "boundary_soften" | "repair_attempt" | "repair_landed" | "closeness_invite" | "withdrawal_mark" | "self_assertion" | "task_recenter";
 export type WritebackCalibrationMetric = "trust" | "closeness" | "safety" | "boundary" | "repair" | "silent-carry" | "task-focus";

package/dist/types.js

@@ -137,6 +137,7 @@ export const DEFAULT_APPRAISAL_AXES = {
     abandonmentRisk: 0,
     obedienceStrain: 0,
     selfPreservation: 0,
+    /** @deprecated See AppraisalAxes.taskFocus */
     taskFocus: 0,
 };
 export const DEFAULT_SUBJECT_RESIDUE = {
@@ -146,11 +147,15 @@ export const DEFAULT_SUBJECT_RESIDUE = {
 export const DEFAULT_DYADIC_FIELD = {
     perceivedCloseness: 0.42,
     feltSafety: 0.56,
+    /** @deprecated See DyadicFieldState.expectationGap */
     expectationGap: 0.18,
     repairCapacity: 0.54,
     repairMemory: 0,
+    /** @deprecated See DyadicFieldState.backslidePressure */
     backslidePressure: 0,
+    /** @deprecated See DyadicFieldState.repairFatigue */
     repairFatigue: 0,
+    /** @deprecated See DyadicFieldState.misattunementLoad */
     misattunementLoad: 0,
     boundaryPressure: 0.22,
     unfinishedTension: 0.12,

package/llms.txt

@@ -133,6 +133,8 @@ const output = await engine.processOutput(llmResponse);
 - `process_input`
 - `process_output`
 - `get_state`
+- `set_mode`
+- `get_status_summary`
 - `end_session`
 
 ## Install
@@ -142,6 +144,23 @@ npm install psyche-ai
 npx psyche-mcp
 ```
 
+## Adapter Sub-paths
+
+- `psyche-ai` — core engine (PsycheEngine, MemoryStorageAdapter)
+- `psyche-ai/mcp` — MCP stdio server
+- `psyche-ai/vercel-ai` — Vercel AI SDK middleware
+- `psyche-ai/langchain` — LangChain adapter
+- `psyche-ai/openclaw` — OpenClaw plugin adapter
+- `psyche-ai/http` — HTTP REST API server
+
+## Demo
+
+```bash
+npx psyche-mcp --demo
+```
+
+Runs a 6-round scenario showing how continuous criticism collapses serotonin and trust, while later validation triggers endorphin repair. Add `--zh` for Chinese, `--mbti INTJ` for a specific personality.
+
 ## Runtime Proof
 
 If an agent claims it is already using Psyche in the current environment, require a real probe:

package/openclaw.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "psyche-ai",
   "name": "Artificial Psyche",
-  "description": "Virtual endocrine system, empathy engine, and agency for OpenClaw agents",
-  "version": "9.2.3",
+  "description": "AI-first subjectivity kernel for agents with continuous appraisal, relation dynamics, and adaptive reply loops",
+  "version": "9.2.11",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "psyche-ai",
-  "version": "9.2.9",
+  "version": "10.0.0",
   "description": "AI-first subjectivity kernel for agents with continuous appraisal, relation dynamics, and adaptive reply loops",
   "mcpName": "io.github.Shangri-la-0428/psyche-ai",
   "type": "module",

package/server.json

@@ -1,17 +1,17 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.Shangri-la-0428/psyche-ai",
-  "description": "Emotional intelligence for AI agents: neurotransmitter mood, personality, empathy, trait drift.",
+  "description": "AI-first subjectivity kernel for agents with continuous appraisal, relation dynamics, and adaptive reply loops.",
   "repository": {
     "url": "https://github.com/Shangri-la-0428/oasyce_psyche",
     "source": "github"
   },
-  "version": "9.2.3",
+  "version": "9.2.11",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "psyche-ai",
-      "version": "9.2.3",
+      "version": "9.2.11",
       "transport": {
         "type": "stdio"
       },