psyche-ai 9.2.4 → 9.2.6

package/dist/relation-dynamics.js

@@ -4,7 +4,8 @@
 // Moves the system from "what am I feeling?" toward
 // "what just happened between us, and what is still unresolved?"
 // ============================================================
-import { DEFAULT_DYADIC_FIELD } from "./types.js";
+import { DEFAULT_DYADIC_FIELD, DEFAULT_RELATIONSHIP } from "./types.js";
+import { computeAppraisalAxes, mergeAppraisalResidue } from "./appraisal.js";
 function clamp01(v) {
     return Math.max(0, Math.min(1, v));
 }
@@ -255,6 +256,72 @@ export function computeRelationMove(text, opts) {
     }
     return { type, intensity: score };
 }
+export function resolveRelationContext(state, userId) {
+    const key = userId ?? "_default";
+    const relationship = state.relationships[key]
+        ?? state.relationships._default
+        ?? state.relationships[Object.keys(state.relationships)[0]]
+        ?? DEFAULT_RELATIONSHIP;
+    const field = state.dyadicFields?.[key]
+        ?? state.dyadicFields?._default
+        ?? DEFAULT_DYADIC_FIELD;
+    const pendingSignals = state.pendingRelationSignals?.[key]
+        ?? state.pendingRelationSignals?._default
+        ?? [];
+    return {
+        key,
+        relationship,
+        field,
+        pendingSignals,
+    };
+}
+export function applyRelationalTurn(state, text, opts) {
+    const now = opts.now ?? new Date().toISOString();
+    const relationContext = resolveRelationContext(state, opts.userId);
+    const appraisalAxes = computeAppraisalAxes(text, {
+        mode: opts.mode,
+        stimulus: opts.stimulus,
+        previous: state.subjectResidue?.axes,
+    });
+    const relationMove = computeRelationMove(text, {
+        appraisal: appraisalAxes,
+        stimulus: opts.stimulus,
+        mode: opts.mode,
+        field: relationContext.field,
+        relationship: relationContext.relationship,
+    });
+    const delayedRelation = evolvePendingRelationSignals(relationContext.pendingSignals, relationMove, appraisalAxes, { mode: opts.mode });
+    const field = evolveDyadicField(relationContext.field, relationMove, appraisalAxes, {
+        mode: opts.mode,
+        now,
+        delayedPressure: delayedRelation.delayedPressure,
+    });
+    return {
+        state: {
+            ...state,
+            subjectResidue: {
+                axes: mergeAppraisalResidue(state.subjectResidue?.axes, appraisalAxes, opts.mode),
+                updatedAt: now,
+            },
+            dyadicFields: {
+                ...(state.dyadicFields ?? {}),
+                [relationContext.key]: field,
+            },
+            pendingRelationSignals: {
+                ...(state.pendingRelationSignals ?? {}),
+                [relationContext.key]: delayedRelation.signals,
+            },
+        },
+        appraisalAxes,
+        relationMove,
+        delayedPressure: delayedRelation.delayedPressure,
+        relationContext: {
+            ...relationContext,
+            field,
+            pendingSignals: delayedRelation.signals,
+        },
+    };
+}
 export function evolveDyadicField(previous, move, appraisal, opts) {
     const prev = previous ?? DEFAULT_DYADIC_FIELD;
     const baseline = DEFAULT_DYADIC_FIELD;

package/dist/reply-envelope.d.ts

@@ -0,0 +1,17 @@
+import type { AppraisalAxes, GenerationControls, Locale, PolicyModifiers, PsycheState, ResolvedRelationContext, ResponseContract, StimulusType, SubjectivityKernel } from "./types.js";
+export interface ReplyEnvelope {
+    policyModifiers: PolicyModifiers;
+    subjectivityKernel: SubjectivityKernel;
+    responseContract: ResponseContract;
+    generationControls: GenerationControls;
+    policyContext: string;
+    subjectivityContext: string;
+    responseContractContext: string;
+}
+export declare function deriveReplyEnvelope(state: PsycheState, appraisal: AppraisalAxes, opts: {
+    locale: Locale;
+    userText?: string;
+    algorithmStimulus?: StimulusType | null;
+    personalityIntensity?: number;
+    relationContext?: ResolvedRelationContext;
+}): ReplyEnvelope;

package/dist/reply-envelope.js

@@ -0,0 +1,36 @@
+// ============================================================
+// 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.
+// ============================================================
+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 function deriveReplyEnvelope(state, appraisal, opts) {
+    const policyModifiers = computePolicyModifiers(state);
+    const subjectivityKernel = computeSubjectivityKernel(state, policyModifiers, appraisal, opts.relationContext);
+    const responseContract = computeResponseContract(subjectivityKernel, {
+        locale: opts.locale,
+        userText: opts.userText,
+        algorithmStimulus: opts.algorithmStimulus,
+        personalityIntensity: opts.personalityIntensity,
+    });
+    const generationControls = deriveGenerationControls({
+        responseContract,
+        policyModifiers,
+    });
+    const policyContext = buildPolicyContext(policyModifiers, opts.locale, state.drives);
+    const subjectivityContext = buildSubjectivityContext(subjectivityKernel, opts.locale);
+    const responseContractContext = buildResponseContractContext(responseContract, opts.locale);
+    return {
+        policyModifiers,
+        subjectivityKernel,
+        responseContract,
+        generationControls,
+        policyContext,
+        subjectivityContext,
+        responseContractContext,
+    };
+}

package/dist/response-contract.js

@@ -8,11 +8,63 @@ const EMOTIONAL_STIMULI = new Set(["vulnerability", "intimacy", "neglect"]);
 function clampInt(v, min, max) {
     return Math.max(min, Math.min(max, Math.round(v)));
 }
-function computeLengthBudget(locale, userText, expressionMode, kernel) {
+function deriveReplyProfile(kernel) {
+    const taskFocused = kernel.taskPlane.focus >= 0.62;
+    const disciplined = kernel.taskPlane.discipline >= 0.72;
+    if (taskFocused && disciplined) {
+        return { replyProfile: "work", replyProfileBasis: "task-focus+discipline" };
+    }
+    if (taskFocused) {
+        return { replyProfile: "work", replyProfileBasis: "task-focus" };
+    }
+    if (disciplined) {
+        return { replyProfile: "work", replyProfileBasis: "discipline" };
+    }
+    return { replyProfile: "private", replyProfileBasis: "default-private" };
+}
+function computeLengthBudget(locale, userText, replyProfile, expressionMode, kernel) {
     const len = userText.length;
     let maxSentences = 2;
     let maxChars;
-    if (locale === "zh") {
+    if (replyProfile === "work") {
+        if (locale === "zh") {
+            if (len <= 10) {
+                maxSentences = 2;
+                maxChars = 36;
+            }
+            else if (len <= 40) {
+                maxSentences = 3;
+                maxChars = clampInt(len * 2.4, 48, 220);
+            }
+            else if (len <= 120) {
+                maxSentences = 5;
+                maxChars = clampInt(len * 1.9, 120, 420);
+            }
+            else {
+                maxSentences = 6;
+                maxChars = clampInt(len * 1.5, 180, 720);
+            }
+        }
+        else {
+            if (len <= 16) {
+                maxSentences = 2;
+                maxChars = 48;
+            }
+            else if (len <= 60) {
+                maxSentences = 3;
+                maxChars = clampInt(len * 2.3, 64, 280);
+            }
+            else if (len <= 180) {
+                maxSentences = 5;
+                maxChars = clampInt(len * 1.8, 140, 520);
+            }
+            else {
+                maxSentences = 6;
+                maxChars = clampInt(len * 1.45, 220, 900);
+            }
+        }
+    }
+    else if (locale === "zh") {
         if (len <= 6) {
             maxSentences = 1;
             maxChars = 15;
@@ -49,39 +101,81 @@ function computeLengthBudget(locale, userText, expressionMode, kernel) {
         }
     }
     if (expressionMode === "brief") {
-        maxSentences = Math.max(1, Math.min(maxSentences, 2));
-        maxChars = maxChars !== undefined ? clampInt(maxChars * 0.85, 10, maxChars) : maxChars;
+        maxSentences = replyProfile === "work"
+            ? Math.max(2, Math.min(maxSentences, 4))
+            : Math.max(1, Math.min(maxSentences, 2));
+        maxChars = maxChars !== undefined
+            ? clampInt(maxChars * (replyProfile === "work" ? 0.9 : 0.85), replyProfile === "work" ? 36 : 10, maxChars)
+            : maxChars;
     }
     else if (expressionMode === "expansive") {
-        maxSentences = Math.min(4, maxSentences + 1);
-        maxChars = maxChars !== undefined ? clampInt(maxChars * 1.1, maxChars, Math.max(maxChars, 260)) : maxChars;
+        maxSentences = Math.min(replyProfile === "work" ? 6 : 4, maxSentences + 1);
+        maxChars = maxChars !== undefined
+            ? clampInt(maxChars * 1.1, maxChars, Math.max(maxChars, replyProfile === "work" ? 900 : 260))
+            : maxChars;
     }
     if (kernel?.taskPlane.focus && kernel.taskPlane.focus > 0.72) {
-        maxSentences = Math.max(1, Math.min(maxSentences, 2));
-        maxChars = maxChars !== undefined ? clampInt(maxChars * 0.82, 10, maxChars) : maxChars;
+        if (replyProfile === "work") {
+            maxSentences = Math.max(2, maxSentences);
+            maxChars = maxChars !== undefined ? clampInt(maxChars * 1.05, 48, Math.max(maxChars, 720)) : 160;
+        }
+        else {
+            maxSentences = Math.max(1, Math.min(maxSentences, 2));
+            maxChars = maxChars !== undefined ? clampInt(maxChars * 0.82, 10, maxChars) : maxChars;
+        }
     }
     if (kernel?.subjectPlane.guardedness && kernel.subjectPlane.guardedness > 0.72) {
-        maxSentences = 1;
-        maxChars = maxChars !== undefined ? clampInt(maxChars * 0.72, 8, maxChars) : 18;
+        if (replyProfile === "work") {
+            maxSentences = Math.max(2, Math.min(maxSentences, 3));
+            maxChars = maxChars !== undefined ? clampInt(maxChars * 0.88, 84, maxChars) : 112;
+        }
+        else {
+            maxSentences = 1;
+            maxChars = maxChars !== undefined ? clampInt(maxChars * 0.72, 8, maxChars) : 18;
+        }
     }
     if (kernel?.ambiguityPlane.expressionInhibition && kernel.ambiguityPlane.expressionInhibition > 0.66) {
-        maxSentences = 1;
-        maxChars = maxChars !== undefined ? clampInt(maxChars * 0.76, 8, maxChars) : 18;
+        if (replyProfile === "work") {
+            maxSentences = Math.max(2, Math.min(maxSentences, 3));
+            maxChars = maxChars !== undefined ? clampInt(maxChars * 0.9, 96, maxChars) : 136;
+        }
+        else {
+            maxSentences = 1;
+            maxChars = maxChars !== undefined ? clampInt(maxChars * 0.76, 8, maxChars) : 18;
+        }
     }
     if (kernel?.relationPlane.silentCarry && kernel.relationPlane.silentCarry > 0.54) {
-        maxSentences = Math.max(1, Math.min(maxSentences, 2));
-        maxChars = maxChars !== undefined ? clampInt(maxChars * 0.82, 8, maxChars) : 20;
+        maxSentences = Math.max(replyProfile === "work" ? 2 : 1, Math.min(maxSentences, replyProfile === "work" ? 3 : 2));
+        maxChars = maxChars !== undefined ? clampInt(maxChars * 0.82, replyProfile === "work" ? 96 : 8, maxChars) : (replyProfile === "work" ? 136 : 20);
     }
     if (kernel?.relationPlane.hysteresis && kernel.relationPlane.hysteresis > 0.64) {
-        maxSentences = 1;
-        maxChars = maxChars !== undefined ? clampInt(maxChars * 0.78, 8, maxChars) : 18;
+        if (replyProfile === "work") {
+            maxSentences = Math.max(2, Math.min(maxSentences, 3));
+            maxChars = maxChars !== undefined ? clampInt(maxChars * 0.84, 104, maxChars) : 144;
+        }
+        else {
+            maxSentences = 1;
+            maxChars = maxChars !== undefined ? clampInt(maxChars * 0.78, 8, maxChars) : 18;
+        }
     }
     if (kernel?.relationPlane.repairFriction && kernel.relationPlane.repairFriction > 0.62) {
-        maxSentences = 1;
-        maxChars = maxChars !== undefined ? clampInt(maxChars * 0.74, 8, maxChars) : 16;
+        if (replyProfile === "work") {
+            maxSentences = Math.max(2, Math.min(maxSentences, 3));
+            maxChars = maxChars !== undefined ? clampInt(maxChars * 0.82, 96, maxChars) : 128;
+        }
+        else {
+            maxSentences = 1;
+            maxChars = maxChars !== undefined ? clampInt(maxChars * 0.74, 8, maxChars) : 16;
+        }
     }
     return { maxSentences, maxChars };
 }
+function buildStimulusReportingGuide(locale) {
+    if (locale === "zh") {
+        return "stimulus速记:闲聊casual/命令authority/认同validation/示弱vulnerability/冷淡neglect/批评criticism";
+    }
+    return "stimulus map: chat=casual / command=authority / agreement=validation / vulnerable=vulnerability / cold=neglect / criticism=criticism";
+}
 function detectToneParticles(userText, locale) {
     if (locale !== "zh")
         return "natural";
@@ -100,9 +194,15 @@ export function computeResponseContract(kernel, opts) {
     const locale = opts?.locale ?? "zh";
     const userText = opts?.userText ?? "";
     const personalityIntensity = opts?.personalityIntensity ?? 0.7;
+    const { replyProfile, replyProfileBasis } = deriveReplyProfile(kernel);
     const { maxSentences, maxChars } = userText.length > 0
-        ? computeLengthBudget(locale, userText, kernel.expressionMode, kernel)
-        : { maxSentences: kernel.expressionMode === "brief" ? 1 : kernel.expressionMode === "expansive" ? 3 : 2, maxChars: undefined };
+        ? computeLengthBudget(locale, userText, replyProfile, kernel.expressionMode, kernel)
+        : {
+            maxSentences: replyProfile === "work"
+                ? (kernel.expressionMode === "expansive" ? 5 : 3)
+                : kernel.expressionMode === "brief" ? 1 : kernel.expressionMode === "expansive" ? 3 : 2,
+            maxChars: replyProfile === "work" ? 160 : undefined,
+        };
     let updateMode = "none";
     if (kernel.taskPlane.focus > 0.72) {
         updateMode = "none";
@@ -165,6 +265,8 @@ export function computeResponseContract(kernel, opts) {
         initiativeMode = "reactive";
     }
     return {
+        replyProfile,
+        replyProfileBasis,
         maxSentences,
         maxChars,
         expressionMode: kernel.expressionMode,
@@ -177,9 +279,26 @@ export function computeResponseContract(kernel, opts) {
         updateMode,
     };
 }
+function describeReplyProfileBasis(basis, locale) {
+    if (locale === "zh") {
+        switch (basis) {
+            case "task-focus":
+                return "因:聚焦";
+            case "discipline":
+                return "因:纪律";
+            case "task-focus+discipline":
+                return "因:聚焦+纪律";
+            default:
+                return "因:默认私人";
+        }
+    }
+    return `basis:${basis}`;
+}
 export function buildResponseContractContext(contract, locale = "zh") {
     if (locale === "zh") {
         const parts = [];
+        parts.push(contract.replyProfile === "work" ? "工作面" : "私人面");
+        parts.push(describeReplyProfileBasis(contract.replyProfileBasis, locale));
         const shape = contract.maxChars
             ? `${contract.maxSentences === 1 ? "1句内" : `最多${contract.maxSentences}句`}，≤${contract.maxChars}字`
             : `${contract.maxSentences === 1 ? "1句内" : `最多${contract.maxSentences}句`}`;
@@ -207,14 +326,18 @@ export function buildResponseContractContext(contract, locale = "zh") {
         if (contract.emojiLimit > 0)
             parts.push(`表情≤${contract.emojiLimit}`);
         if (contract.updateMode === "stimulus")
-            parts.push("补报stimulus");
+            parts.push(buildStimulusReportingGuide(locale));
         else if (contract.updateMode === "empathy")
             parts.push("对方谈感受时再报empathy");
-        else if (contract.updateMode === "stimulus+empathy")
-            parts.push("补报stimulus；对方谈感受时再报empathy");
+        else if (contract.updateMode === "stimulus+empathy") {
+            parts.push(buildStimulusReportingGuide(locale));
+            parts.push("对方谈感受时再报empathy");
+        }
         return `[回应契约] ${parts.join("；")}。`;
     }
     const parts = [];
+    parts.push(contract.replyProfile === "work" ? "work surface" : "private surface");
+    parts.push(describeReplyProfileBasis(contract.replyProfileBasis, locale));
     const shape = contract.maxChars
         ? `${contract.maxSentences === 1 ? "1 sentence" : `up to ${contract.maxSentences} sentences`}, <= ${contract.maxChars} chars`
         : `${contract.maxSentences === 1 ? "1 sentence" : `up to ${contract.maxSentences} sentences`}`;
@@ -240,10 +363,12 @@ export function buildResponseContractContext(contract, locale = "zh") {
     if (contract.emojiLimit > 0)
         parts.push(`emoji <= ${contract.emojiLimit}`);
     if (contract.updateMode === "stimulus")
-        parts.push("report stimulus");
+        parts.push(buildStimulusReportingGuide(locale));
     else if (contract.updateMode === "empathy")
         parts.push("report empathy only when feelings are shared");
-    else if (contract.updateMode === "stimulus+empathy")
-        parts.push("report stimulus, and empathy only when feelings are shared");
+    else if (contract.updateMode === "stimulus+empathy") {
+        parts.push(buildStimulusReportingGuide(locale));
+        parts.push("report empathy only when feelings are shared");
+    }
     return `[Reply Contract] ${parts.join(", ")}.`;
 }

package/dist/subjectivity.d.ts

@@ -1,3 +1,3 @@
-import type { AppraisalAxes, Locale, PolicyModifiers, PsycheState, SubjectivityKernel } from "./types.js";
-export declare function computeSubjectivityKernel(state: PsycheState, policyModifiers?: PolicyModifiers, appraisal?: AppraisalAxes, userId?: string): SubjectivityKernel;
+import type { AppraisalAxes, Locale, PolicyModifiers, PsycheState, SubjectivityKernel, ResolvedRelationContext } from "./types.js";
+export declare function computeSubjectivityKernel(state: PsycheState, policyModifiers?: PolicyModifiers, appraisal?: AppraisalAxes, relationContextOrUserId?: ResolvedRelationContext | string): SubjectivityKernel;
 export declare function buildSubjectivityContext(kernel: SubjectivityKernel, locale?: Locale): string;

package/dist/subjectivity.js

@@ -7,7 +7,7 @@
 import { DEFAULT_APPRAISAL_AXES, DEFAULT_DYADIC_FIELD, DRIVE_KEYS } from "./types.js";
 import { computeAttentionWeights, computeDecisionBias, computePolicyModifiers } from "./decision-bias.js";
 import { getResidueIntensity } from "./appraisal.js";
-import { getLoopPressure } from "./relation-dynamics.js";
+import { getLoopPressure, resolveRelationContext } from "./relation-dynamics.js";
 function clamp01(v) {
     return Math.max(0, Math.min(1, v));
 }
@@ -47,10 +47,11 @@ function pickAttentionAnchor(state, tension, warmth) {
     candidates.sort((a, b) => b[1] - a[1]);
     return candidates[0][0];
 }
-function computeRelationPlane(state, appraisal, userId) {
-    const key = userId ?? "_default";
-    const rel = state.relationships[key] ?? state.relationships._default ?? state.relationships[Object.keys(state.relationships)[0]];
-    const field = state.dyadicFields?.[key] ?? state.dyadicFields?._default ?? DEFAULT_DYADIC_FIELD;
+function computeRelationPlane(state, appraisal, relationContext) {
+    const rel = relationContext?.relationship
+        ?? state.relationships._default
+        ?? state.relationships[Object.keys(state.relationships)[0]];
+    const field = relationContext?.field ?? DEFAULT_DYADIC_FIELD;
     const loopPressure = getLoopPressure(field);
     const closeness = wavg([
         field.perceivedCloseness,
@@ -112,9 +113,8 @@ function computeRelationPlane(state, appraisal, userId) {
         lastMove: field.lastMove,
     };
 }
-function computeAmbiguityPlane(state, appraisal, relationPlane, userId) {
-    const key = userId ?? "_default";
-    const pendingSignals = state.pendingRelationSignals?.[key] ?? state.pendingRelationSignals?._default ?? [];
+function computeAmbiguityPlane(state, appraisal, relationPlane, relationContext) {
+    const pendingSignals = relationContext?.pendingSignals ?? [];
     const pendingPressure = clamp01(pendingSignals.reduce((sum, signal) => sum + signal.intensity * (signal.readyInTurns > 0 ? 0.55 : 0.35), 0));
     const baseConflict = wavg([
         Math.min(relationPlane.closeness, Math.max(relationPlane.loopPressure, appraisal.selfPreservation)),
@@ -219,13 +219,22 @@ function computeSubjectPlane(state, warmth, guard, appraisal, relationPlane) {
         residue: residueIntensity,
     };
 }
-export function computeSubjectivityKernel(state, policyModifiers = computePolicyModifiers(state), appraisal = state.subjectResidue?.axes ?? DEFAULT_APPRAISAL_AXES, userId) {
+function normalizeRelationContext(state, relationContextOrUserId) {
+    if (!relationContextOrUserId)
+        return resolveRelationContext(state);
+    if (typeof relationContextOrUserId === "string") {
+        return resolveRelationContext(state, relationContextOrUserId);
+    }
+    return relationContextOrUserId;
+}
+export function computeSubjectivityKernel(state, policyModifiers = computePolicyModifiers(state), appraisal = state.subjectResidue?.axes ?? DEFAULT_APPRAISAL_AXES, relationContextOrUserId) {
+    const relationContext = normalizeRelationContext(state, relationContextOrUserId);
     const c = state.current;
-    const rel = state.relationships[userId ?? "_default"]
+    const rel = relationContext?.relationship
         ?? state.relationships._default
         ?? state.relationships[Object.keys(state.relationships)[0]];
-    const relationPlane = computeRelationPlane(state, appraisal, userId);
-    const ambiguityPlane = computeAmbiguityPlane(state, appraisal, relationPlane, userId);
+    const relationPlane = computeRelationPlane(state, appraisal, relationContext);
+    const ambiguityPlane = computeAmbiguityPlane(state, appraisal, relationPlane, relationContext);
     const bias = computeDecisionBias(state);
     const energySignal = state.energyBudgets
         ? (norm(state.energyBudgets.attention)

package/dist/temporal.d.ts

@@ -25,7 +25,7 @@ export declare function predictNextStimulus(emotionalHistory: ChemicalSnapshot[]
  * High-probability positive prediction -> DA/OT micro-rise.
  * High-probability negative prediction -> CORT micro-rise.
  */
-export declare function generateAnticipation(predictions: StimulusPrediction[], currentChemistry: ChemicalState): AnticipationState;
+export declare function generateAnticipation(predictions: StimulusPrediction[], _currentChemistry: ChemicalState): AnticipationState;
 /**
  * Compute disappointment/surprise when actual stimulus differs from prediction.
  * Returns additional chemistry delta beyond the normal stimulus response.
@@ -35,4 +35,4 @@ export declare function computeSurpriseEffect(anticipated: AnticipationState, ac
  * Evaluate if the last interaction would have gone better with different chemistry.
  * Runs a counterfactual: "what if my chemistry had been at baseline?"
  */
-export declare function computeRegret(preInteractionState: PsycheState, postInteractionState: PsycheState, outcomeScore: number, appliedStimulus: StimulusType | null): RegretEntry | null;
+export declare function computeRegret(preInteractionState: PsycheState, postInteractionState: PsycheState, outcomeScore: number, _appliedStimulus: StimulusType | null): RegretEntry | null;

package/dist/temporal.js

@@ -142,7 +142,7 @@ function buildPhasePrior(weights) {
  * High-probability positive prediction -> DA/OT micro-rise.
  * High-probability negative prediction -> CORT micro-rise.
  */
-export function generateAnticipation(predictions, currentChemistry) {
+export function generateAnticipation(predictions, _currentChemistry) {
     const anticipation = {};
     for (const key of CHEMICAL_KEYS) {
         anticipation[key] = 0;
@@ -231,7 +231,7 @@ const CHEMICAL_DESCRIPTIONS = {
  * Evaluate if the last interaction would have gone better with different chemistry.
  * Runs a counterfactual: "what if my chemistry had been at baseline?"
  */
-export function computeRegret(preInteractionState, postInteractionState, outcomeScore, appliedStimulus) {
+export function computeRegret(preInteractionState, postInteractionState, outcomeScore, _appliedStimulus) {
     // Only generate regret for bad outcomes
     if (outcomeScore >= -0.2) {
         return null;

package/dist/types.d.ts

@@ -27,12 +27,18 @@ export declare const DRIVE_NAMES_ZH: Record<DriveType, string>;
 /** Human-readable names for each chemical */
 export declare const CHEMICAL_NAMES: Record<keyof ChemicalState, string>;
 export declare const CHEMICAL_NAMES_ZH: Record<keyof ChemicalState, string>;
+export interface ChemicalRuntimeSpec {
+    normalMin: number;
+    normalMax: number;
+    halfLifeHours: number;
+}
 /** Decay speed category */
 export type DecaySpeed = "fast" | "medium" | "slow";
 /** Decay factor per chemical (applied per hour) */
 export declare const DECAY_FACTORS: Record<DecaySpeed, number>;
 /** Which chemicals decay at which speed */
 export declare const CHEMICAL_DECAY_SPEED: Record<keyof ChemicalState, DecaySpeed>;
+export declare const CHEMICAL_RUNTIME_SPECS: Record<keyof ChemicalState, ChemicalRuntimeSpec>;
 /** Psyche operating mode */
 export type PsycheMode = "natural" | "work" | "companion";
 /** Big Five personality traits (0-100 each) */
@@ -87,6 +93,8 @@ export interface ChemicalSnapshot {
     stimulus: StimulusType | null;
     dominantEmotion: string | null;
     timestamp: string;
+    semanticSummary?: string;
+    semanticPoints?: string[];
     intensity?: number;
     valence?: number;
     isCoreMemory?: boolean;
@@ -166,11 +174,30 @@ export declare const MAX_DEFENSE_PATTERNS = 10;
 export type RegulationStrategyType = "reappraisal" | "strategic-expression" | "self-soothing";
 /** Defense mechanism type */
 export type DefenseMechanismType = "rationalization" | "projection" | "sublimation" | "avoidance";
+/** Which internal metric a regulation action is trying to pull back toward target */
+export type RegulationTargetMetric = keyof ChemicalState | "emotional-confidence";
+/** Whether the last regulation action is helping */
+export type RegulationFeedbackEffect = "converging" | "holding" | "diverging";
+export interface RegulationFeedback {
+    strategy: RegulationStrategyType;
+    targetMetric: RegulationTargetMetric;
+    effect: RegulationFeedbackEffect;
+    gapBefore: number;
+    gapNow: number;
+}
 /** Record of a past regulation attempt */
 export interface RegulationRecord {
     strategy: RegulationStrategyType;
     timestamp: string;
     effective: boolean;
+    action?: string;
+    horizonTurns?: number;
+    remainingTurns?: number;
+    targetMetric?: RegulationTargetMetric;
+    targetValue?: number;
+    gapBefore?: number;
+    gapLatest?: number;
+    effect?: RegulationFeedbackEffect;
 }
 /** Tracked defense pattern frequency */
 export interface DefensePatternRecord {
@@ -185,6 +212,7 @@ export interface MetacognitiveState {
     /** Running average of emotional confidence across assessments */
     avgEmotionalConfidence: number;
     totalAssessments: number;
+    lastRegulationFeedback?: RegulationFeedback | null;
 }
 /** Default empty metacognitive state */
 export declare const DEFAULT_METACOGNITIVE_STATE: MetacognitiveState;
@@ -365,6 +393,13 @@ export interface DyadicFieldState {
     lastMove: RelationMoveType;
     updatedAt: string;
 }
+/** Resolved per-partner view used across the hot path */
+export interface ResolvedRelationContext {
+    key: string;
+    relationship: RelationshipState;
+    field: DyadicFieldState;
+    pendingSignals: PendingRelationSignalState[];
+}
 export declare const DEFAULT_DYADIC_FIELD: DyadicFieldState;
 export interface AmbiguityPlaneState {
     /** How confidently the system should name what is happening */
@@ -463,6 +498,10 @@ export interface SubjectivityKernel {
  * in a compact, host-consumable form.
  */
 export interface ResponseContract {
+    /** Which conversational surface this turn belongs to */
+    replyProfile: "work" | "private";
+    /** Why the current turn was classified into that conversational surface */
+    replyProfileBasis: "task-focus" | "discipline" | "task-focus+discipline" | "default-private";
     /** Maximum suggested sentence count */
     maxSentences: number;
     /** Maximum suggested character count, when a concrete cap is available */

package/dist/types.js

@@ -56,6 +56,17 @@ export const CHEMICAL_DECAY_SPEED = {
     NE: "fast",
     END: "fast",
 };
+function decayHalfLifeHours(decayPerHour) {
+    return Math.log(0.5) / Math.log(decayPerHour);
+}
+export const CHEMICAL_RUNTIME_SPECS = {
+    DA: { normalMin: 35, normalMax: 75, halfLifeHours: decayHalfLifeHours(DECAY_FACTORS.medium) },
+    HT: { normalMin: 40, normalMax: 75, halfLifeHours: decayHalfLifeHours(DECAY_FACTORS.slow) },
+    CORT: { normalMin: 20, normalMax: 55, halfLifeHours: decayHalfLifeHours(DECAY_FACTORS.medium) },
+    OT: { normalMin: 35, normalMax: 75, halfLifeHours: decayHalfLifeHours(DECAY_FACTORS.slow) },
+    NE: { normalMin: 30, normalMax: 70, halfLifeHours: decayHalfLifeHours(DECAY_FACTORS.fast) },
+    END: { normalMin: 30, normalMax: 70, halfLifeHours: decayHalfLifeHours(DECAY_FACTORS.fast) },
+};
 /** Default attachment for new relationships */
 export const DEFAULT_ATTACHMENT = {
     style: "secure",
@@ -95,6 +106,7 @@ export const DEFAULT_METACOGNITIVE_STATE = {
     defensePatterns: [],
     avgEmotionalConfidence: 0.5,
     totalAssessments: 0,
+    lastRegulationFeedback: null,
 };
 // ── Personhood Types (v6) ────────────────────────────────────
 /** Max causal insights to persist */

package/llms.txt

@@ -114,5 +114,5 @@ npx psyche-mcp                                     # Run MCP server directly
 ## Links
 
 - npm: https://www.npmjs.com/package/psyche-ai
-- GitHub: https://github.com/Shangri-la-0428/psyche-ai
+- GitHub: https://github.com/Shangri-la-0428/oasyce_psyche
 - License: MIT