psyche-ai 9.2.9 → 10.0.0

package/README.md

@@ -1,7 +1,7 @@
 # Psyche — 面向智能体的 AI-first 主观性内核
 
 [![npm](https://img.shields.io/npm/v/psyche-ai)](https://www.npmjs.com/package/psyche-ai)
-[![tests](https://img.shields.io/badge/tests-1308%20passing-brightgreen)]()
+[![tests](https://img.shields.io/badge/tests-1316%20passing-brightgreen)]()
 [![deps](https://img.shields.io/badge/dependencies-0-blue)]()
 [![license](https://img.shields.io/badge/license-MIT-yellow)](LICENSE)
 
@@ -63,6 +63,11 @@ Psyche 要解决的不可压缩问题只有一个：
 - `Oasyce Net = policy, operations, and resource orchestration`
 - `Oasyce Chain = account truth, authorization truth, commitments, settlement, and public finality`
 
+授权真相流也固定成单向：
+`Chain -> Net -> Thronglets -> Psyche`
+
+也就是说，`Psyche` 不判断“谁被授权”，它只读取已经成立的执行边界结果。
+
 正式版本见：
 
 - [docs/IDENTITY_MODEL.md](docs/IDENTITY_MODEL.md)
@@ -179,11 +184,17 @@ npx psyche-mcp --demo
 
 ## 30 秒安装
 
+```bash
+npm install psyche-ai
+```
+
+或者通过 OpenClaw 插件安装：
+
 ```bash
 openclaw plugins install psyche-ai
 ```
 
-没了。装完自动生效。
+验证：
 
 ```bash
 openclaw plugins list | grep psyche
@@ -326,6 +337,16 @@ Psyche 现在更准确的目标，不是“模仿某种像人的风格”，而
 
 当前主线里，`processInput()` 会直接返回 `replyEnvelope` 作为规范主接口；原有平级字段继续保留为兼容别名，避免打断现有宿主。`policyModifiers` 不再属于规范主接口，只保留为 legacy raw vector。
 
+在这个规范主接口之外，`processInput()` 现在还会可选返回一个很薄的 `observability` side-channel。它不是新的控制面，也不会反向改写 `replyEnvelope`；它只回答五件事：
+
+- 这轮当前由哪一个控制平面主导
+- 当前 turn / writeback / session bridge / persisted relationship 四层是怎么对账的
+- 这次 `work/private` 选择为什么会落在这个 profile 上
+- 这轮和上一轮、session bridge、writeback、external continuity 之间的因果引用链是什么
+- 当前 low-frequency external continuity 事件如何映射成 `localTraceRefs / signalRefs / traceRefs / summaryCandidateRefs`
+
+这样别的 agent 或宿主不用再自己猜“现在到底是谁在主导”和“为什么这次选了这个策略”，但主链路仍然只有 `replyEnvelope` 一个真相源。
+
 ### 内在世界
 
 Psyche 给 AI 一个始终运转的内在自我——不是条件触发，而是每时每刻都在：
@@ -547,7 +568,7 @@ Psyche 核心引擎永久开源（MIT）。
 ```bash
 npm install
 npm run build
-npm test           # 1308 tests
+npm test           # 1316 tests
 npm run typecheck  # strict mode
 ```
 

package/dist/cli.js

@@ -140,7 +140,7 @@ async function cmdInit(dir, mbti, name, lang, mode, traits, _noPersist) {
         state.meta.mode = mode;
         await saveState(absDir, state);
     }
-    console.log(`\nPsyche initialized for ${state.meta.agentName} (${state.mbti})\n`);
+    console.log(`\nPsyche initialized for ${state.meta.agentName}${state.mbti ? ` (preset: ${state.mbti})` : ""}\n`);
     printChemistry(state);
     console.log(`\nFiles created:`);
     console.log(`  ${absDir}/psyche-state.json`);
@@ -165,7 +165,12 @@ async function cmdStatus(dir, json, userId) {
     const emotion = describeEmotionalState(state.current, locale);
     const hint = getExpressionHint(state.current, locale);
     const elapsed = ((Date.now() - new Date(state.updatedAt).getTime()) / 60000).toFixed(1);
-    console.log(`\n${state.meta.agentName} (${state.mbti}) — ${emotion}\n`);
+    const baselineSummary = [
+        state.baseline.DA < 55 ? "introvert" : "extrovert",
+        state.baseline.DA > state.baseline.HT ? "intuitive" : "sensing",
+        state.baseline.OT >= 50 ? "feeling" : "thinking",
+    ].join("/");
+    console.log(`\n${state.meta.agentName} (${baselineSummary}) — ${emotion}\n`);
     printChemistry(state);
     console.log();
     printDrives(state);
@@ -264,7 +269,7 @@ async function cmdReset(dir, full) {
     }
     await saveState(absDir, state);
     await generatePsycheMd(absDir, state);
-    console.log(`\n${state.meta.agentName} reset to baseline (${state.mbti})${full ? " [full reset including relationships]" : ""}\n`);
+    console.log(`\n${state.meta.agentName} reset to baseline${full ? " [full reset including relationships]" : ""}\n`);
     printChemistry(state);
     console.log();
 }

package/dist/core.d.ts

@@ -1,4 +1,4 @@
-import type { PsycheState, StimulusType, Locale, MBTIType, OutcomeScore, PsycheMode, PersonalityTraits, PolicyModifiers, ClassifierProvider, SubjectivityKernel, ResponseContract, GenerationControls, SessionBridgeState, ThrongletsExport, WritebackCalibrationFeedback, WritebackSignalType, ExternalContinuityEnvelope } from "./types.js";
+import type { PsycheState, StimulusType, Locale, MBTIType, OutcomeScore, PsycheMode, PersonalityTraits, PolicyModifiers, ClassifierProvider, SubjectivityKernel, ResponseContract, GenerationControls, SessionBridgeState, ThrongletsExport, TurnObservability, WritebackCalibrationFeedback, WritebackSignalType, ExternalContinuityEnvelope } from "./types.js";
 import type { StorageAdapter } from "./storage.js";
 import type { DiagnosticReport, SessionMetrics } from "./diagnostics.js";
 import type { ReplyEnvelope } from "./reply-envelope.js";
@@ -9,7 +9,7 @@ export interface PsycheEngineConfig {
     stripUpdateTags?: boolean;
     emotionalContagionRate?: number;
     maxChemicalDelta?: number;
-    /** Compact mode: algorithms handle chemistry, LLM only sees behavioral output. Default: true */
+    /** @deprecated Compact mode is always on since v10. This option is ignored. */
     compactMode?: boolean;
     /** Operating mode: "natural" (default), "work" (minimal emotions), "companion" (full emotions) */
     mode?: PsycheMode;
@@ -57,6 +57,8 @@ export interface ProcessInputResult {
     externalContinuity?: ExternalContinuityEnvelope<ThrongletsExport>;
     /** v9.2.8: sparse low-frequency export surface suitable for Thronglets */
     throngletsExports?: ThrongletsExport[];
+    /** v9.2.10: low-cost side channel for control boundary, state layers, and output attribution */
+    observability?: TurnObservability;
     /**
      * Legacy compatibility alias: ready-to-use prompt fragment summarizing raw policy modifiers.
      *

package/dist/core.js

@@ -15,7 +15,7 @@ import { DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_M
 import { MemoryStorageAdapter } from "./storage.js";
 import { applyDecay, applyStimulus, applyContagion, clamp, describeEmotionalState } from "./chemistry.js";
 import { classifyStimulus, BuiltInClassifier, buildLLMClassifierPrompt, parseLLMClassification } from "./classify.js";
-import { buildDynamicContext, buildProtocolContext, buildCompactContext } from "./prompt.js";
+import { buildCompactContext, buildProtocolContext } from "./prompt.js";
 import { getSensitivity, getBaseline, getDefaultSelfModel, traitsToBaseline } from "./profiles.js";
 import { isStimulusType } from "./guards.js";
 import { parsePsycheUpdate, mergeUpdates, updateAgreementStreak, pushSnapshot, compressSession, summarizeTurnSemantic, } from "./psyche-file.js";
@@ -28,6 +28,7 @@ import { runReflectiveTurnPhases } from "./input-turn.js";
 import { applyRelationalTurn, applySessionBridge, applyWritebackSignals, createWritebackCalibrations, evaluateWritebackCalibrations } from "./relation-dynamics.js";
 import { buildExternalContinuityEnvelope } from "./external-continuity.js";
 import { deriveThrongletsExports } from "./thronglets-export.js";
+import { buildTurnObservability } from "./observability.js";
 function formatWritebackFeedbackNote(feedback, locale) {
     const top = feedback?.[0];
     if (!top)
@@ -296,7 +297,7 @@ export class PsycheEngine {
             };
         }
         // v9: Energy budget recovery during absence + depletion per turn
-        const isExtravert = this.cfg.mbti.startsWith("E");
+        const isExtravert = state.baseline.DA >= 55;
         const currentBudgets = state.energyBudgets ?? { ...DEFAULT_ENERGY_BUDGETS };
         let energyBudgets = minutesElapsed >= 5
             ? computeEnergyRecovery(currentBudgets, minutesElapsed, isExtravert)
@@ -336,7 +337,7 @@ export class PsycheEngine {
                 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);
+                const effectiveSensitivity = computeEffectiveSensitivity((state.sensitivity ?? 1.0), drives, primary.type, state.traitDrift);
                 // v9.2: Confidence modulates intensity — a 0.95 life-or-death dilemma
                 // hits ~1.7x harder than a 0.55 mild disagreement.
                 // Maps [0.5, 1.0] → [0.6, 1.2] via linear interpolation.
@@ -422,7 +423,7 @@ export class PsycheEngine {
         // ── Generate prediction for next turn's auto-learning ────
         if (appliedStimulus) {
             const ctxHash = computeContextHash(state, opts?.userId);
-            const effectiveSensitivity = computeEffectiveSensitivity(getSensitivity(state.mbti), state.drives, appliedStimulus, state.traitDrift);
+            const effectiveSensitivity = computeEffectiveSensitivity((state.sensitivity ?? 1.0), state.drives, appliedStimulus, state.traitDrift);
             const predicted = predictChemistry(preInteractionState.current, appliedStimulus, state.learning, ctxHash, effectiveSensitivity, this.cfg.maxChemicalDelta);
             this.pendingPrediction = {
                 predictedChemistry: predicted,
@@ -479,30 +480,24 @@ export class PsycheEngine {
             subjectivityContext: derivedReplyEnvelope.subjectivityContext,
             responseContractContext: derivedReplyEnvelope.responseContractContext,
             policyContext: derivedReplyEnvelope.policyContext || undefined,
+            sessionBridge,
         };
-        if (this.cfg.compactMode) {
-            const externalContinuity = buildExternalContinuityEnvelope(throngletsExports);
-            return {
-                systemContext: "",
-                dynamicContext: buildCompactContext(state, opts?.userId, promptRenderInputs),
-                stimulus: appliedStimulus,
-                stimulusConfidence: this.lastStimulusAssessment?.confidence,
-                replyEnvelope,
-                policyModifiers: derivedReplyEnvelope.policyModifiers,
-                subjectivityKernel: replyEnvelope.subjectivityKernel,
-                responseContract: replyEnvelope.responseContract,
-                generationControls: replyEnvelope.generationControls,
-                sessionBridge,
-                writebackFeedback,
-                externalContinuity,
-                throngletsExports,
-                policyContext: derivedReplyEnvelope.policyContext,
-            };
-        }
+        const observability = buildTurnObservability(state, {
+            replyEnvelope,
+            promptRenderInputs,
+            compactMode: this.cfg.compactMode,
+            stimulus: appliedStimulus,
+            userText: text || undefined,
+            sessionBridge,
+            writebackFeedback,
+            relationContext: relationalTurn.relationContext,
+            externalContinuityEvents: throngletsExports,
+        });
+        // v10: compact mode is always on. Legacy buildDynamicContext removed from engine path.
         const externalContinuity = buildExternalContinuityEnvelope(throngletsExports);
         return {
-            systemContext: this.getProtocol(locale),
-            dynamicContext: buildDynamicContext(state, opts?.userId, promptRenderInputs),
+            systemContext: "",
+            dynamicContext: buildCompactContext(state, opts?.userId, promptRenderInputs),
             stimulus: appliedStimulus,
             stimulusConfidence: this.lastStimulusAssessment?.confidence,
             replyEnvelope,
@@ -514,6 +509,7 @@ export class PsycheEngine {
             writebackFeedback,
             externalContinuity,
             throngletsExports,
+            observability,
             policyContext: derivedReplyEnvelope.policyContext,
         };
     }
@@ -545,7 +541,7 @@ export class PsycheEngine {
                 const selfFeedbackRate = 0.3;
                 state = {
                     ...state,
-                    current: applyContagion(state.current, selfPrimary.type, selfFeedbackRate, getSensitivity(state.mbti)),
+                    current: applyContagion(state.current, selfPrimary.type, selfFeedbackRate, (state.sensitivity ?? 1.0)),
                 };
                 stateChanged = true;
                 // v9.2 P4: Autonomic recovery — expressing vulnerable/comforting emotions
@@ -588,7 +584,7 @@ export class PsycheEngine {
                         ...state,
                         drives: feedDrives(state.drives, parseResult.llmStimulus),
                     };
-                    const effectiveSensitivity = computeEffectiveSensitivity(getSensitivity(state.mbti), state.drives, parseResult.llmStimulus, state.traitDrift);
+                    const effectiveSensitivity = computeEffectiveSensitivity((state.sensitivity ?? 1.0), state.drives, parseResult.llmStimulus, state.traitDrift);
                     state = {
                         ...state,
                         current: applyStimulus(state.current, parseResult.llmStimulus, effectiveSensitivity * (overrideAllowed && this._lastAlgorithmApplied ? 0.8 : 1), this.cfg.maxChemicalDelta, NOOP_LOGGER),
@@ -772,14 +768,15 @@ export class PsycheEngine {
     }
     createDefaultState() {
         const { mbti, name, locale } = this.cfg;
-        // Use Big Five traits if provided, otherwise use MBTI baseline
+        // Use Big Five traits if provided, otherwise use preset baseline
         const baseline = this.traits ? traitsToBaseline(this.traits).baseline : getBaseline(mbti);
+        const sensitivity = this.traits ? 1.0 : getSensitivity(mbti);
         const selfModel = getDefaultSelfModel(mbti);
         const now = new Date().toISOString();
         return {
-            version: 9,
-            mbti,
+            version: 10,
             baseline,
+            sensitivity,
             current: { ...baseline },
             drives: { ...DEFAULT_DRIVES },
             updatedAt: now,
@@ -824,7 +821,7 @@ export class PsycheEngine {
      */
     async resetState(opts) {
         let state = this.ensureInitialized();
-        const baseline = this.traits ? traitsToBaseline(this.traits).baseline : getBaseline(state.mbti);
+        const baseline = this.traits ? traitsToBaseline(this.traits).baseline : { ...state.baseline };
         state = {
             ...state,
             current: { ...baseline },

package/dist/diagnostics.d.ts

@@ -1,8 +1,15 @@
 import type { AppraisalAxes, PsycheState, ChemicalState, StimulusType, InnateDrives } from "./types.js";
+/**
+ * The four diagnostic layers, matching the frozen stack.
+ * When something breaks, the first question is: which layer?
+ */
+export type DiagnosticLayer = "subjective-continuity" | "delegate-continuity" | "policy-orchestration" | "public-truth";
 export type Severity = "critical" | "warning" | "info";
 export interface DiagnosticIssue {
     id: string;
     severity: Severity;
+    /** Which stack layer this issue belongs to */
+    layer: DiagnosticLayer;
     message: string;
     detail?: string;
     /** Dev-facing: what to fix in our code or config */
@@ -40,8 +47,12 @@ export interface DiagnosticReport {
     version: string;
     timestamp: string;
     agent: string;
-    mbti: string;
+    mbti?: string;
     issues: DiagnosticIssue[];
+    /** Issues grouped by stack layer — same issues as `issues`, partitioned */
+    layeredIssues: Record<DiagnosticLayer, DiagnosticIssue[]>;
+    /** Per-layer health summary — the first thing to read when something is wrong */
+    layerHealth: LayerHealthSummary;
     metrics: SessionMetrics;
     stateSnapshot: {
         chemistry: ChemicalState;
@@ -54,7 +65,47 @@ export interface DiagnosticReport {
         stateVersion: number;
     };
 }
+export type LayerStatus = "healthy" | "degraded" | "failing";
+export interface LayerHealthDetail {
+    status: LayerStatus;
+    /** Worst severity found in this layer (null = no issues) */
+    worstSeverity: Severity | null;
+    issueCount: number;
+    /** One-line human-readable summary */
+    summary: string;
+}
+export interface LayerHealthSummary {
+    "subjective-continuity": LayerHealthDetail & {
+        /** Chemistry deviation from baseline (0 = identical) */
+        chemistryDeviation: number;
+        /** Session bridge present and carrying identity state */
+        sessionBridgeActive: boolean;
+        /** Trait drift trajectory established */
+        traitDriftEstablished: boolean;
+        /** Number of active dyadic relations */
+        activeDyadicRelations: number;
+        /** Average prediction error (0-1, lower = better calibrated) */
+        predictionError: number;
+    };
+    "delegate-continuity": LayerHealthDetail & {
+        /** External continuity contract connected */
+        externalContinuityConnected: boolean;
+        /** Number of pending exports waiting for Thronglets */
+        pendingExports: number;
+        /** Writeback calibration loop active */
+        writebackLoopActive: boolean;
+        /** Last calibration effect breakdown */
+        calibrationEffects: {
+            converging: number;
+            holding: number;
+            diverging: number;
+        };
+    };
+    "policy-orchestration": LayerHealthDetail;
+    "public-truth": LayerHealthDetail;
+}
 export declare function runHealthCheck(state: PsycheState): DiagnosticIssue[];
+export declare function computeLayerHealthSummary(state: PsycheState, issues: DiagnosticIssue[]): LayerHealthSummary;
 export declare class DiagnosticCollector {
     private metrics;
     private prevChemistry;