psyche-ai 9.2.3 → 9.2.4

package/dist/core.js

@@ -11,7 +11,7 @@
 //
 // Orchestrates: chemistry, classify, prompt, profiles, guards, learning
 // ============================================================
-import { DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, DEFAULT_PERSONHOOD_STATE, DEFAULT_ENERGY_BUDGETS, DEFAULT_TRAIT_DRIFT } from "./types.js";
+import { DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, DEFAULT_PERSONHOOD_STATE, DEFAULT_ENERGY_BUDGETS, DEFAULT_TRAIT_DRIFT, DEFAULT_SUBJECT_RESIDUE, DEFAULT_DYADIC_FIELD } from "./types.js";
 import { MemoryStorageAdapter } from "./storage.js";
 import { applyDecay, applyStimulus, applyContagion, clamp, describeEmotionalState } from "./chemistry.js";
 import { classifyStimulus, BuiltInClassifier, buildLLMClassifierPrompt, parseLLMClassification } from "./classify.js";
@@ -20,7 +20,7 @@ import { getSensitivity, getBaseline, getDefaultSelfModel, traitsToBaseline } fr
 import { isStimulusType } from "./guards.js";
 import { parsePsycheUpdate, mergeUpdates, updateAgreementStreak, pushSnapshot, compressSession, } from "./psyche-file.js";
 import { decayDrives, feedDrives, detectExistentialThreat, computeEffectiveBaseline, computeEffectiveSensitivity, } from "./drives.js";
-import { checkForUpdate } from "./update.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";
@@ -32,7 +32,85 @@ 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";
 const NOOP_LOGGER = { info: () => { }, warn: () => { }, debug: () => { } };
+const REPAIRING_STIMULI = new Set(["praise", "validation", "intimacy"]);
+const RELATIONSHIP_DELTAS = {
+    praise: { trust: 1.5, intimacy: 0.8 },
+    validation: { trust: 1.8, intimacy: 0.8 },
+    intimacy: { trust: 1.2, intimacy: 2.0 },
+    vulnerability: { trust: 0.8, intimacy: 1.5 },
+    humor: { trust: 0.6, intimacy: 0.5 },
+    casual: { trust: 0.2, intimacy: 0.1 },
+    intellectual: { trust: 0.5, intimacy: 0.1 },
+    surprise: { trust: 0.2, intimacy: 0 },
+    boredom: { trust: -0.4, intimacy: -0.3 },
+    criticism: { trust: -1.5, intimacy: -0.8 },
+    sarcasm: { trust: -1.8, intimacy: -1.2 },
+    authority: { trust: -1.2, intimacy: -0.9 },
+    neglect: { trust: -1.6, intimacy: -1.4 },
+    conflict: { trust: -2.5, intimacy: -2.0 },
+};
+function applyRepairLag(previous, next, baseline, stimulus) {
+    if (!REPAIRING_STIMULI.has(stimulus))
+        return next;
+    const stressLoad = Math.max(0, previous.CORT - baseline.CORT);
+    if (stressLoad < 15)
+        return next;
+    // High stress slows emotional recovery so apology/praise doesn't instantly
+    // snap chemistry back to baseline.
+    const repairFactor = Math.max(0.35, 1 - stressLoad / 50);
+    const adjusted = { ...next };
+    for (const key of ["DA", "HT", "OT", "END"]) {
+        const delta = next[key] - previous[key];
+        if (delta > 0) {
+            adjusted[key] = clamp(previous[key] + delta * repairFactor);
+        }
+    }
+    const cortDelta = next.CORT - previous.CORT;
+    if (cortDelta < 0) {
+        adjusted.CORT = clamp(previous.CORT + cortDelta * repairFactor);
+    }
+    return adjusted;
+}
+function phaseFromRelationship(trust, intimacy) {
+    const avg = (trust + intimacy) / 2;
+    if (avg >= 80)
+        return "deep";
+    if (avg >= 60)
+        return "close";
+    if (avg >= 40)
+        return "familiar";
+    if (avg >= 20)
+        return "acquaintance";
+    return "stranger";
+}
+function applyRelationshipDrift(state, stimulus, userId) {
+    const delta = RELATIONSHIP_DELTAS[stimulus];
+    if (!delta)
+        return state;
+    const key = userId ?? "_default";
+    const currentRel = state.relationships[key] ?? { ...DEFAULT_RELATIONSHIP };
+    const trust = clamp(currentRel.trust + delta.trust);
+    const intimacy = clamp(currentRel.intimacy + delta.intimacy);
+    const updatedRel = {
+        ...currentRel,
+        trust,
+        intimacy,
+        phase: phaseFromRelationship(trust, intimacy),
+    };
+    return {
+        ...state,
+        relationships: {
+            ...state.relationships,
+            [key]: updatedRel,
+        },
+    };
+}
 // ── PsycheEngine ─────────────────────────────────────────────
 export class PsycheEngine {
     state = null;
@@ -77,9 +155,6 @@ export class PsycheEngine {
         }
         // Diagnostics: on by default, opt-out with diagnostics: false
         this.diagnosticCollector = config.diagnostics === false ? null : new DiagnosticCollector();
-        if (this.diagnosticCollector) {
-            this.diagnosticCollector.onWarning = (msg) => console.warn(`\x1b[33m[Psyche]\x1b[0m ${msg}`);
-        }
         this.feedbackUrl = config.feedbackUrl ?? "https://psyche-feedback.wutc.workers.dev";
     }
     /**
@@ -120,6 +195,18 @@ export class PsycheEngine {
                 loaded.version = 9;
                 console.log("\x1b[36m[Psyche]\x1b[0m 已从 v8 升级到 v9 — 新增：真实人格漂移、能量预算、习惯化、行为策略输出。详见 https://github.com/Shangri-la-0428/psyche-ai");
             }
+            if (!loaded.dyadicFields) {
+                loaded.dyadicFields = {
+                    _default: {
+                        ...DEFAULT_DYADIC_FIELD,
+                        openLoops: [],
+                        updatedAt: new Date().toISOString(),
+                    },
+                };
+            }
+            if (!loaded.pendingRelationSignals) {
+                loaded.pendingRelationSignals = { _default: [] };
+            }
             this.state = loaded;
         }
         else {
@@ -230,6 +317,7 @@ export class PsycheEngine {
             let current = state.current;
             if (primary && primary.confidence >= 0.5) {
                 appliedStimulus = primary.type;
+                const preStimulus = current;
                 // Feed drives from stimulus, then apply stimulus with drive-modified sensitivity
                 drives = feedDrives(drives, primary.type);
                 const effectiveSensitivity = computeEffectiveSensitivity(getSensitivity(state.mbti), drives, primary.type, state.traitDrift);
@@ -243,12 +331,52 @@ export class PsycheEngine {
                 const recentSameCount = (state.emotionalHistory ?? [])
                     .filter(s => s.stimulus === primary.type).length + 1; // +1 for current
                 current = applyStimulus(current, primary.type, effectiveSensitivity * this.cfg.personalityIntensity * modeMultiplier * confidenceIntensity, effectiveMaxDelta, NOOP_LOGGER, recentSameCount);
+                current = applyRepairLag(preStimulus, current, state.baseline, primary.type);
             }
             state = { ...state, drives, current };
+            if (appliedStimulus) {
+                state = applyRelationshipDrift(state, appliedStimulus, opts?.userId);
+            }
         }
         // v9: Deplete energy budgets from this interaction turn
         energyBudgets = computeEnergyDepletion(energyBudgets, appliedStimulus, isExtravert);
         state = { ...state, energyBudgets };
+        const appraisalAxes = computeAppraisalAxes(text, {
+            mode: this.cfg.mode,
+            stimulus: appliedStimulus,
+            previous: state.subjectResidue?.axes,
+        });
+        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,
+            },
+        };
         // 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;
@@ -408,7 +536,7 @@ export class PsycheEngine {
         await this.storage.save(state);
         // Auto-diagnostics: record this input
         if (this.diagnosticCollector) {
-            this.diagnosticCollector.recordInput(appliedStimulus, appliedStimulus ? 1.0 : 0.0, state.current);
+            this.diagnosticCollector.recordInput(appliedStimulus, appliedStimulus ? 1.0 : 0.0, state.current, appraisalAxes);
         }
         // Build metacognitive and decision context strings
         const metacogNote = metacognitiveAssessment?.metacognitiveNote;
@@ -418,7 +546,20 @@ export class PsycheEngine {
         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, {
+            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,
+        });
         // P10: Append processing depth info to autonomic description when depth is low
         let autonomicDesc;
         if (autonomicResult.state !== "ventral-vagal") {
@@ -445,10 +586,15 @@ export class PsycheEngine {
                     autonomicDescription: autonomicDesc,
                     autonomicState: autonomicResult.state,
                     primarySystemsDescription: primarySystemsDescription || undefined,
+                    subjectivityContext: subjectivityCtx,
+                    responseContractContext: responseContractCtx,
                     policyContext: policyCtx || undefined,
                 }),
                 stimulus: appliedStimulus,
                 policyModifiers,
+                subjectivityKernel,
+                responseContract,
+                generationControls,
                 policyContext: policyCtx,
             };
         }
@@ -467,6 +613,9 @@ export class PsycheEngine {
             }),
             stimulus: appliedStimulus,
             policyModifiers,
+            subjectivityKernel,
+            responseContract,
+            generationControls,
             policyContext: policyCtx,
         };
     }
@@ -614,7 +763,7 @@ export class PsycheEngine {
     }
     /**
      * End the current session: compress emotionalHistory into a rich summary
-     * stored in relationship.memory[], then clear the history.
+     * stored in relationship.memory[], then preserve only core/recent context.
      * Auto-generates diagnostic report and persists to log.
      *
      * @returns DiagnosticReport if diagnostics are enabled, null otherwise
@@ -625,7 +774,7 @@ export class PsycheEngine {
         let report = null;
         if (this.diagnosticCollector) {
             const metrics = this.diagnosticCollector.getMetrics();
-            report = generateReport(state, metrics, "9.1.2");
+            report = generateReport(state, metrics, await getPackageVersion());
             this.lastReport = report;
             // Persist to JSONL log via storage adapter
             if (this.storage.appendLog) {
@@ -719,6 +868,18 @@ export class PsycheEngine {
             sessionStartedAt: now,
             traitDrift: { ...DEFAULT_TRAIT_DRIFT },
             energyBudgets: { ...DEFAULT_ENERGY_BUDGETS },
+            subjectResidue: {
+                axes: { ...DEFAULT_SUBJECT_RESIDUE.axes },
+                updatedAt: now,
+            },
+            dyadicFields: {
+                _default: {
+                    ...DEFAULT_DYADIC_FIELD,
+                    openLoops: [],
+                    updatedAt: now,
+                },
+            },
+            pendingRelationSignals: { _default: [] },
             meta: {
                 agentName: name,
                 createdAt: now,
@@ -746,6 +907,18 @@ export class PsycheEngine {
             autonomicState: "ventral-vagal",
             sessionStartedAt: undefined,
             updatedAt: new Date().toISOString(),
+            subjectResidue: {
+                axes: { ...DEFAULT_SUBJECT_RESIDUE.axes },
+                updatedAt: new Date().toISOString(),
+            },
+            dyadicFields: {
+                _default: {
+                    ...DEFAULT_DYADIC_FIELD,
+                    openLoops: [],
+                    updatedAt: new Date().toISOString(),
+                },
+            },
+            pendingRelationSignals: { _default: [] },
             relationships: opts?.preserveRelationships !== false
                 ? state.relationships
                 : { _default: { ...DEFAULT_RELATIONSHIP } },

package/dist/diagnostics.d.ts

@@ -1,4 +1,4 @@
-import type { PsycheState, ChemicalState, StimulusType, InnateDrives } from "./types.js";
+import type { AppraisalAxes, PsycheState, ChemicalState, StimulusType, InnateDrives } from "./types.js";
 export type Severity = "critical" | "warning" | "info";
 export interface DiagnosticIssue {
     id: string;
@@ -13,6 +13,10 @@ export interface SessionMetrics {
     inputCount: number;
     /** How many returned a non-null stimulus */
     classifiedCount: number;
+    /** How many had a non-trivial appraisal hit (excluding taskFocus) */
+    appraisalHitCount: number;
+    /** How many were recognized by either stimulus or appraisal */
+    semanticHitCount: number;
     /** Stimulus distribution */
     stimulusDistribution: Partial<Record<StimulusType, number>>;
     /** Average classification confidence */
@@ -55,19 +59,17 @@ export declare class DiagnosticCollector {
     private metrics;
     private prevChemistry;
     private confidences;
-    /** Consecutive inputs with no classification — for real-time alerting */
-    private consecutiveNone;
-    /** Callback for real-time warnings (set by adapter) */
-    onWarning?: (message: string) => void;
     constructor();
     /** Record a processInput result */
-    recordInput(stimulus: StimulusType | null, confidence: number, chemistry: ChemicalState): void;
+    recordInput(stimulus: StimulusType | null, confidence: number, chemistry: ChemicalState, appraisal?: AppraisalAxes): void;
     /** Record an error */
     recordError(phase: string, error: unknown): void;
     /** Get current session metrics */
     getMetrics(): SessionMetrics;
     /** Get classifier hit rate (0-1) */
     getClassifierRate(): number;
+    /** Get semantic recognition rate (stimulus or appraisal, 0-1) */
+    getSemanticRate(): number;
 }
 export declare function generateReport(state: PsycheState, metrics: SessionMetrics, packageVersion: string): DiagnosticReport;
 export declare function formatReport(report: DiagnosticReport): string;

package/dist/diagnostics.js

@@ -152,15 +152,13 @@ export class DiagnosticCollector {
     metrics;
     prevChemistry = null;
     confidences = [];
-    /** Consecutive inputs with no classification — for real-time alerting */
-    consecutiveNone = 0;
-    /** Callback for real-time warnings (set by adapter) */
-    onWarning;
     constructor() {
         const now = new Date().toISOString();
         this.metrics = {
             inputCount: 0,
             classifiedCount: 0,
+            appraisalHitCount: 0,
+            semanticHitCount: 0,
             stimulusDistribution: {},
             avgConfidence: 0,
             totalChemistryDelta: 0,
@@ -171,22 +169,20 @@ export class DiagnosticCollector {
         };
     }
     /** Record a processInput result */
-    recordInput(stimulus, confidence, chemistry) {
+    recordInput(stimulus, confidence, chemistry, appraisal) {
         this.metrics.inputCount++;
         this.metrics.lastActivityAt = new Date().toISOString();
         if (stimulus) {
             this.metrics.classifiedCount++;
             this.metrics.stimulusDistribution[stimulus] =
                 (this.metrics.stimulusDistribution[stimulus] ?? 0) + 1;
-            this.consecutiveNone = 0;
         }
-        else {
-            this.consecutiveNone++;
-            if (this.consecutiveNone >= 3) {
-                this.onWarning?.(`Psyche: ${this.consecutiveNone} consecutive inputs with no classification ` +
-                    `(0/${this.metrics.inputCount} total). Possible causes: empty input text, ` +
-                    `wrong event field, or classifier rules don't match input language.`);
-            }
+        const appraisalHit = hasSemanticAppraisal(appraisal);
+        if (appraisalHit) {
+            this.metrics.appraisalHitCount++;
+        }
+        if (stimulus || appraisalHit) {
+            this.metrics.semanticHitCount++;
         }
         this.confidences.push(confidence);
         this.metrics.avgConfidence =
@@ -218,17 +214,36 @@ export class DiagnosticCollector {
             ? this.metrics.classifiedCount / this.metrics.inputCount
             : 0;
     }
+    /** Get semantic recognition rate (stimulus or appraisal, 0-1) */
+    getSemanticRate() {
+        return this.metrics.inputCount > 0
+            ? this.metrics.semanticHitCount / this.metrics.inputCount
+            : 0;
+    }
+}
+function hasSemanticAppraisal(appraisal) {
+    if (!appraisal)
+        return false;
+    return Math.max(appraisal.identityThreat, appraisal.memoryDoubt, appraisal.attachmentPull, appraisal.abandonmentRisk, appraisal.obedienceStrain, appraisal.selfPreservation) >= 0.28;
 }
 // ── Report Generation ────────────────────────────────────────
 export function generateReport(state, metrics, packageVersion) {
     const issues = runHealthCheck(state);
     // Session-level issues
-    if (metrics.inputCount >= 5 && metrics.classifiedCount === 0) {
+    if (metrics.inputCount >= 5 && metrics.semanticHitCount === 0) {
         issues.push({
-            id: "SESSION_NO_CLASSIFY",
+            id: "SESSION_NO_RECOGNITION",
             severity: "critical",
-            message: `0/${metrics.inputCount} inputs classified this session`,
-            suggestion: `整个会话分类全挂。优先级：1) 检查用户 locale 是否匹配 classify.ts 的语言规则 2) SHORT_MESSAGE_MAP 是否覆盖短消息 3) 考虑开启 llmClassifier fallback`,
+            message: `0/${metrics.inputCount} inputs produced any semantic recognition this session`,
+            suggestion: `整条识别链都没工作：先看 OpenClaw 输入文本是否带元数据包装，再看 classify.ts 和 appraisal.ts 是否真的吃到了净化后的用户原文`,
+        });
+    }
+    else if (metrics.inputCount >= 5 && metrics.classifiedCount === 0 && metrics.semanticHitCount > 0) {
+        issues.push({
+            id: "SESSION_APPRAISAL_ONLY",
+            severity: "info",
+            message: `0/${metrics.inputCount} inputs hit legacy stimulus labels, but ${metrics.semanticHitCount}/${metrics.inputCount} hit appraisal axes`,
+            suggestion: `这说明主体识别在工作，但旧 stimulus taxonomy 没覆盖这类输入。是否继续补 classify.ts，取决于你是否还把 stimulus 当主要观测口径`,
         });
     }
     if (metrics.inputCount >= 3 && metrics.totalChemistryDelta < 1) {
@@ -311,7 +326,10 @@ export function formatReport(report) {
     lines.push("  session metrics:");
     const m = report.metrics;
     const rate = m.inputCount > 0 ? Math.round(m.classifiedCount / m.inputCount * 100) : 0;
+    const appraisalRate = m.inputCount > 0 ? Math.round(m.appraisalHitCount / m.inputCount * 100) : 0;
+    const semanticRate = m.inputCount > 0 ? Math.round(m.semanticHitCount / m.inputCount * 100) : 0;
     lines.push(`    inputs: ${m.inputCount} | classified: ${m.classifiedCount} (${rate}%)`);
+    lines.push(`    appraisal hits: ${m.appraisalHitCount} (${appraisalRate}%) | recognized: ${m.semanticHitCount} (${semanticRate}%)`);
     lines.push(`    avg confidence: ${m.avgConfidence.toFixed(2)}`);
     lines.push(`    chemistry delta: total=${m.totalChemistryDelta.toFixed(1)} max=${m.maxChemistryDelta.toFixed(1)}`);
     lines.push(`    errors: ${m.errors.length}`);
@@ -387,8 +405,12 @@ export function toGitHubIssueBody(report) {
     lines.push("| Metric | Value |");
     lines.push("|--------|-------|");
     const rate = m.inputCount > 0 ? Math.round(m.classifiedCount / m.inputCount * 100) : 0;
+    const appraisalRate = m.inputCount > 0 ? Math.round(m.appraisalHitCount / m.inputCount * 100) : 0;
+    const semanticRate = m.inputCount > 0 ? Math.round(m.semanticHitCount / m.inputCount * 100) : 0;
     lines.push(`| Inputs | ${m.inputCount} |`);
     lines.push(`| Classified | ${m.classifiedCount} (${rate}%) |`);
+    lines.push(`| Appraisal Hits | ${m.appraisalHitCount} (${appraisalRate}%) |`);
+    lines.push(`| Recognized | ${m.semanticHitCount} (${semanticRate}%) |`);
     lines.push(`| Avg Confidence | ${m.avgConfidence.toFixed(2)} |`);
     lines.push(`| Chemistry Delta | total: ${m.totalChemistryDelta.toFixed(1)}, max: ${m.maxChemistryDelta.toFixed(1)} |`);
     lines.push(`| Errors | ${m.errors.length} |`);
@@ -418,6 +440,12 @@ export function formatLogEntry(report) {
         classifyRate: report.metrics.inputCount > 0
             ? +(report.metrics.classifiedCount / report.metrics.inputCount).toFixed(2)
             : 0,
+        appraisalRate: report.metrics.inputCount > 0
+            ? +(report.metrics.appraisalHitCount / report.metrics.inputCount).toFixed(2)
+            : 0,
+        recognitionRate: report.metrics.inputCount > 0
+            ? +(report.metrics.semanticHitCount / report.metrics.inputCount).toFixed(2)
+            : 0,
         errors: report.metrics.errors.length,
         chemDelta: +report.metrics.totalChemistryDelta.toFixed(1),
     });
@@ -452,6 +480,14 @@ export async function submitFeedback(report, url, timeout = 5000) {
             classifyRate: report.metrics.inputCount > 0
                 ? +(report.metrics.classifiedCount / report.metrics.inputCount).toFixed(2)
                 : 0,
+            appraisalHits: report.metrics.appraisalHitCount,
+            appraisalRate: report.metrics.inputCount > 0
+                ? +(report.metrics.appraisalHitCount / report.metrics.inputCount).toFixed(2)
+                : 0,
+            recognized: report.metrics.semanticHitCount,
+            recognitionRate: report.metrics.inputCount > 0
+                ? +(report.metrics.semanticHitCount / report.metrics.inputCount).toFixed(2)
+                : 0,
             chemDelta: +report.metrics.totalChemistryDelta.toFixed(1),
             maxChemDelta: +report.metrics.maxChemistryDelta.toFixed(1),
             errors: report.metrics.errors.length,

package/dist/host-controls.d.ts

@@ -0,0 +1,5 @@
+import type { GenerationControls, PolicyModifiers, ResponseContract } from "./types.js";
+export declare function deriveGenerationControls(input: {
+    responseContract?: ResponseContract;
+    policyModifiers?: Pick<PolicyModifiers, "requireConfirmation">;
+}, existingMaxTokens?: number): GenerationControls;

package/dist/host-controls.js

@@ -0,0 +1,48 @@
+// ============================================================
+// Host Controls — derive mechanical generation constraints
+//
+// Maps psyche output into a tiny host-consumable control surface.
+// ============================================================
+function clampInt(v, min, max) {
+    return Math.max(min, Math.min(max, Math.round(v)));
+}
+function estimateMaxTokens(contract) {
+    if (!contract)
+        return undefined;
+    let budget;
+    if (contract.maxChars !== undefined) {
+        budget = clampInt(contract.maxChars * 2.2, 64, 1024);
+    }
+    else if (contract.expressionMode === "brief") {
+        budget = 96;
+    }
+    else if (contract.expressionMode === "expansive") {
+        budget = 640;
+    }
+    else {
+        budget = 256;
+    }
+    if (contract.maxSentences <= 1)
+        budget = Math.min(budget, 96);
+    else if (contract.maxSentences === 2)
+        budget = Math.min(budget, 160);
+    else if (contract.maxSentences === 3)
+        budget = Math.min(budget, 320);
+    if (contract.initiativeMode === "reactive") {
+        budget = clampInt(budget * 0.85, 64, 1024);
+    }
+    return budget;
+}
+export function deriveGenerationControls(input, existingMaxTokens) {
+    const recommendedMax = estimateMaxTokens(input.responseContract);
+    const maxTokens = recommendedMax !== undefined
+        ? existingMaxTokens !== undefined
+            ? Math.min(existingMaxTokens, recommendedMax)
+            : recommendedMax
+        : existingMaxTokens;
+    return {
+        maxTokens,
+        requireConfirmation: input.policyModifiers?.requireConfirmation
+            ?? (input.responseContract?.boundaryMode === "confirm-first"),
+    };
+}

package/dist/index.d.ts

@@ -2,8 +2,8 @@ export { PsycheEngine } from "./core.js";
 export type { PsycheEngineConfig, ProcessInputResult, ProcessOutputResult, ProcessOutcomeResult } from "./core.js";
 export { FileStorageAdapter, MemoryStorageAdapter } from "./storage.js";
 export type { StorageAdapter } from "./storage.js";
-export type { PsycheState, MBTIType, Locale, StimulusType, ChemicalState, ChemicalSnapshot, SelfModel, RelationshipState, EmpathyEntry, EmotionPattern, DriveType, InnateDrives, LearningState, LearnedVectorAdjustment, PredictionRecord, OutcomeScore, OutcomeSignals, AttachmentStyle, AttachmentData, MetacognitiveState, RegulationRecord, DefensePatternRecord, RegulationStrategyType, DefenseMechanismType, PersonhoodState, PersistedCausalInsight, GrowthDirection, PersonalityTraits, PsycheMode, PolicyModifiers, TraitDriftState, EnergyBudgets, ClassifierProvider, ClassifierContext, ClassificationResult, } from "./types.js";
-export { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, DEFAULT_PERSONHOOD_STATE, DEFAULT_ATTACHMENT, DRIVE_KEYS, DRIVE_NAMES_ZH, DEFAULT_TRAIT_DRIFT, DEFAULT_ENERGY_BUDGETS, } from "./types.js";
+export type { PsycheState, MBTIType, Locale, StimulusType, ChemicalState, ChemicalSnapshot, SelfModel, RelationshipState, EmpathyEntry, EmotionPattern, DriveType, InnateDrives, LearningState, LearnedVectorAdjustment, PredictionRecord, OutcomeScore, OutcomeSignals, AttachmentStyle, AttachmentData, MetacognitiveState, RegulationRecord, DefensePatternRecord, RegulationStrategyType, DefenseMechanismType, PersonhoodState, PersistedCausalInsight, GrowthDirection, PersonalityTraits, PsycheMode, PolicyModifiers, SubjectivityKernel, ResponseContract, GenerationControls, AppraisalAxes, SubjectResidue, TaskPlaneState, SubjectPlaneState, RelationPlaneState, AmbiguityPlaneState, RelationMoveType, RelationMove, OpenLoopType, OpenLoopState, PendingRelationSignalState, DyadicFieldState, TraitDriftState, EnergyBudgets, ClassifierProvider, ClassifierContext, ClassificationResult, } from "./types.js";
+export { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, DEFAULT_PERSONHOOD_STATE, DEFAULT_ATTACHMENT, DRIVE_KEYS, DRIVE_NAMES_ZH, DEFAULT_TRAIT_DRIFT, DEFAULT_ENERGY_BUDGETS, DEFAULT_APPRAISAL_AXES, DEFAULT_SUBJECT_RESIDUE, DEFAULT_DYADIC_FIELD, } from "./types.js";
 export { computeSelfReflection, computeEmotionalTendency, buildSelfReflectionContext } from "./self-recognition.js";
 export type { SelfReflection } from "./self-recognition.js";
 export { PsycheInteraction } from "./interaction.js";
@@ -23,6 +23,11 @@ export { assessMetacognition, computeEmotionalConfidence, generateRegulationSugg
 export type { MetacognitiveAssessment, RegulationSuggestion, DetectedDefense } from "./metacognition.js";
 export { computeDecisionBias, computeAttentionWeights, computeExploreExploit, buildDecisionContext, computePolicyModifiers, buildPolicyContext, } from "./decision-bias.js";
 export type { DecisionBiasVector, AttentionWeights } from "./decision-bias.js";
+export { computeSubjectivityKernel, buildSubjectivityContext } from "./subjectivity.js";
+export { computeResponseContract, buildResponseContractContext } from "./response-contract.js";
+export { deriveGenerationControls } from "./host-controls.js";
+export { computeAppraisalAxes, mergeAppraisalResidue, getResidueIntensity } from "./appraisal.js";
+export { computeRelationMove, evolveDyadicField, evolvePendingRelationSignals, getLoopPressure } from "./relation-dynamics.js";
 export { computeExperientialField, computeCoherence, detectUnnamedEmotion, computeAffectCore } from "./experiential-field.js";
 export type { ExperientialField, ExperientialQuality, ConstructionContext } from "./experiential-field.js";
 export { computeGenerativeSelf, predictSelfReaction, detectInternalConflicts, buildIdentityNarrative } from "./generative-self.js";

package/dist/index.js

@@ -12,7 +12,7 @@
 export { PsycheEngine } from "./core.js";
 // Storage
 export { FileStorageAdapter, MemoryStorageAdapter } from "./storage.js";
-export { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, DEFAULT_PERSONHOOD_STATE, DEFAULT_ATTACHMENT, DRIVE_KEYS, DRIVE_NAMES_ZH, DEFAULT_TRAIT_DRIFT, DEFAULT_ENERGY_BUDGETS, } from "./types.js";
+export { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, DEFAULT_PERSONHOOD_STATE, DEFAULT_ATTACHMENT, DRIVE_KEYS, DRIVE_NAMES_ZH, DEFAULT_TRAIT_DRIFT, DEFAULT_ENERGY_BUDGETS, DEFAULT_APPRAISAL_AXES, DEFAULT_SUBJECT_RESIDUE, DEFAULT_DYADIC_FIELD, } from "./types.js";
 // Self-recognition
 export { computeSelfReflection, computeEmotionalTendency, buildSelfReflectionContext } from "./self-recognition.js";
 // Multi-agent interaction
@@ -33,6 +33,12 @@ export { updateAttachment, computeSeparationEffect, computeReunionEffect, } from
 export { assessMetacognition, computeEmotionalConfidence, generateRegulationSuggestions, detectDefenseMechanisms, } from "./metacognition.js";
 // Decision bias (P5) + PolicyModifiers (v9)
 export { computeDecisionBias, computeAttentionWeights, computeExploreExploit, buildDecisionContext, computePolicyModifiers, buildPolicyContext, } from "./decision-bias.js";
+// Subjectivity kernel (v9.3)
+export { computeSubjectivityKernel, buildSubjectivityContext } from "./subjectivity.js";
+export { computeResponseContract, buildResponseContractContext } from "./response-contract.js";
+export { deriveGenerationControls } from "./host-controls.js";
+export { computeAppraisalAxes, mergeAppraisalResidue, getResidueIntensity } from "./appraisal.js";
+export { computeRelationMove, evolveDyadicField, evolvePendingRelationSignals, getLoopPressure } from "./relation-dynamics.js";
 // Experiential field (P6 + P8 Barrett construction)
 export { computeExperientialField, computeCoherence, detectUnnamedEmotion, computeAffectCore } from "./experiential-field.js";
 // Generative self (P6)

package/dist/prompt.d.ts

@@ -15,6 +15,8 @@ export declare function buildDynamicContext(state: PsycheState, userId?: string,
     autonomicDescription?: string;
     autonomicState?: AutonomicState;
     primarySystemsDescription?: string;
+    subjectivityContext?: string;
+    responseContractContext?: string;
     policyContext?: string;
 }): string;
 /**
@@ -68,5 +70,7 @@ export declare function buildCompactContext(state: PsycheState, userId?: string,
     autonomicDescription?: string;
     autonomicState?: AutonomicState;
     primarySystemsDescription?: string;
+    subjectivityContext?: string;
+    responseContractContext?: string;
     policyContext?: string;
 }): string;