psyche-ai 9.2.6 → 9.2.8

package/dist/input-turn.js

@@ -0,0 +1,164 @@
+// ============================================================
+// Input Turn Pipeline — reflective turn phases after local state evolution
+//
+// Keeps PsycheEngine orchestration slimmer by moving autonomic,
+// metacognitive, experiential, ethical, and reply-envelope derivation
+// into a dedicated post-evolution stage.
+// ============================================================
+import { assessMetacognition, updateMetacognitiveState } from "./metacognition.js";
+import { buildDecisionContext } from "./decision-bias.js";
+import { computeExperientialField } from "./experiential-field.js";
+import { computeGenerativeSelf } from "./generative-self.js";
+import { buildSharedIntentionalityContext, updateSharedIntentionality } from "./shared-intentionality.js";
+import { assessEthics, buildEthicalContext } from "./ethics.js";
+import { computeAutonomicResult } from "./autonomic.js";
+import { computePrimarySystems, computeSystemInteractions, gatePrimarySystemsByAutonomic, describeBehavioralTendencies, } from "./primary-systems.js";
+import { deriveReplyEnvelope } from "./reply-envelope.js";
+import { clamp } from "./chemistry.js";
+export function runReflectiveTurnPhases(input) {
+    let state = input.state;
+    const locale = state.meta.locale ?? input.localeFallback;
+    const autonomicResult = computeAutonomicResult(state.current, state.drives, state.autonomicState ?? null, input.minutesElapsed, locale, state.baseline, state.energyBudgets);
+    state = {
+        ...state,
+        autonomicState: autonomicResult.state,
+    };
+    const skip = new Set(autonomicResult.skippedStages);
+    const rawSystems = computePrimarySystems(state.current, state.drives, input.appliedStimulus);
+    const interactedSystems = computeSystemInteractions(rawSystems);
+    const gatedSystems = gatePrimarySystemsByAutonomic(interactedSystems, autonomicResult.state);
+    const primarySystemsDescription = describeBehavioralTendencies(gatedSystems, locale);
+    let metacognitiveAssessment = null;
+    if (!skip.has("metacognition")) {
+        metacognitiveAssessment = assessMetacognition(state, input.appliedStimulus ?? "casual", state.learning.outcomeHistory);
+        for (const reg of metacognitiveAssessment.regulationSuggestions) {
+            if (reg.strategy === "self-soothing" && reg.confidence >= 0.6 && reg.chemistryAdjustment) {
+                const adj = reg.chemistryAdjustment;
+                state = {
+                    ...state,
+                    current: {
+                        ...state.current,
+                        DA: clamp(state.current.DA + (adj.DA ?? 0)),
+                        HT: clamp(state.current.HT + (adj.HT ?? 0)),
+                        CORT: clamp(state.current.CORT + (adj.CORT ?? 0)),
+                        OT: clamp(state.current.OT + (adj.OT ?? 0)),
+                        NE: clamp(state.current.NE + (adj.NE ?? 0)),
+                        END: clamp(state.current.END + (adj.END ?? 0)),
+                    },
+                };
+            }
+        }
+        state = {
+            ...state,
+            metacognition: updateMetacognitiveState(state.metacognition, metacognitiveAssessment),
+        };
+    }
+    const constructionContext = {
+        autonomicState: autonomicResult.state,
+        stimulus: input.appliedStimulus,
+        relationshipPhase: input.relationContext.relationship.phase,
+        predictionError: state.learning.predictionHistory.length > 0
+            ? state.learning.predictionHistory[state.learning.predictionHistory.length - 1].predictionError
+            : undefined,
+    };
+    const experientialField = skip.has("experiential-field")
+        ? null
+        : computeExperientialField(state, metacognitiveAssessment ?? undefined, undefined, constructionContext);
+    const sharedState = skip.has("shared-intentionality")
+        ? null
+        : updateSharedIntentionality(state, input.appliedStimulus, input.userId);
+    const ethicalAssessment = skip.has("ethics")
+        ? null
+        : assessEthics(state);
+    if (!skip.has("generative-self")
+        && state.meta.totalInteractions % 10 === 0 && state.meta.totalInteractions > 0) {
+        const selfModel = computeGenerativeSelf(state);
+        state = {
+            ...state,
+            personhood: {
+                ...state.personhood,
+                identityNarrative: selfModel.identityNarrative,
+                growthDirection: selfModel.growthArc.direction,
+                causalInsights: selfModel.causalInsights.slice(0, 20).map((ci) => ({
+                    trait: ci.trait,
+                    because: ci.because,
+                    confidence: ci.confidence,
+                    discoveredAt: input.nowIso,
+                })),
+            },
+        };
+    }
+    if (ethicalAssessment && ethicalAssessment.ethicalHealth < 0.7) {
+        const newConcerns = ethicalAssessment.concerns
+            .filter((c) => c.severity > 0.4)
+            .map((c) => ({ type: c.type, severity: c.severity, timestamp: input.nowIso }));
+        if (newConcerns.length > 0) {
+            state = {
+                ...state,
+                personhood: {
+                    ...state.personhood,
+                    ethicalConcernHistory: [
+                        ...state.personhood.ethicalConcernHistory.slice(-14),
+                        ...newConcerns,
+                    ],
+                },
+            };
+        }
+    }
+    if (sharedState && sharedState.theoryOfMind.confidence > 0.3) {
+        const userId = input.userId ?? "_default";
+        state = {
+            ...state,
+            personhood: {
+                ...state.personhood,
+                theoryOfMind: {
+                    ...state.personhood.theoryOfMind,
+                    [userId]: {
+                        estimatedMood: sharedState.theoryOfMind.estimatedMood,
+                        estimatedIntent: sharedState.theoryOfMind.estimatedIntent,
+                        confidence: sharedState.theoryOfMind.confidence,
+                        lastUpdated: sharedState.theoryOfMind.lastUpdated,
+                    },
+                },
+            },
+        };
+    }
+    const metacognitiveNote = input.writebackNote
+        ? [input.writebackNote, metacognitiveAssessment?.metacognitiveNote].filter(Boolean).join("\n")
+        : metacognitiveAssessment?.metacognitiveNote;
+    const decisionContext = buildDecisionContext(state);
+    const ethicsContext = ethicalAssessment ? buildEthicalContext(ethicalAssessment, locale) : undefined;
+    const sharedIntentionalityContext = sharedState ? buildSharedIntentionalityContext(sharedState, locale) : undefined;
+    const experientialNarrative = experientialField?.narrative || undefined;
+    const replyEnvelope = deriveReplyEnvelope(state, input.appraisalAxes, {
+        locale,
+        userText: input.userText,
+        algorithmStimulus: input.appliedStimulus,
+        classificationConfidence: input.classificationConfidence,
+        personalityIntensity: input.personalityIntensity,
+        relationContext: input.relationContext,
+    });
+    let autonomicDescription;
+    if (autonomicResult.state !== "ventral-vagal") {
+        autonomicDescription = autonomicResult.description;
+        if (autonomicResult.processingDepth < 0.5) {
+            const depthNote = locale === "en"
+                ? " Reflective capacity reduced — intuitive reactions."
+                : "反思能力降低——直觉反应中。";
+            autonomicDescription += depthNote;
+        }
+    }
+    return {
+        state,
+        locale,
+        autonomicState: autonomicResult.state,
+        autonomicDescription,
+        primarySystemsDescription: primarySystemsDescription || undefined,
+        metacognitiveNote,
+        decisionContext: decisionContext || undefined,
+        ethicsContext,
+        sharedIntentionalityContext,
+        experientialNarrative,
+        replyEnvelope,
+    };
+}

package/dist/prompt.d.ts

@@ -1,12 +1,11 @@
 import type { PsycheState, Locale, ChemicalSnapshot, PsycheMode } from "./types.js";
 import type { AutonomicState } from "./autonomic.js";
 import type { ChannelType } from "./channels.js";
-/**
- * Build the dynamic per-turn emotional context injected via before_prompt_build.
- *
- * This is the "current moment" — what the agent is feeling RIGHT NOW.
- */
-export declare function buildDynamicContext(state: PsycheState, userId?: string, opts?: {
+export interface PromptRenderInputs {
+    userText?: string;
+    algorithmStimulus?: string | null;
+    personalityIntensity?: number;
+    channelType?: ChannelType;
     metacognitiveNote?: string;
     decisionContext?: string;
     ethicsContext?: string;
@@ -18,7 +17,13 @@ export declare function buildDynamicContext(state: PsycheState, userId?: string,
     subjectivityContext?: string;
     responseContractContext?: string;
     policyContext?: string;
-}): string;
+}
+/**
+ * Build the dynamic per-turn emotional context injected via before_prompt_build.
+ *
+ * This is the "current moment" — what the agent is feeling RIGHT NOW.
+ */
+export declare function buildDynamicContext(state: PsycheState, userId?: string, opts?: PromptRenderInputs): string;
 /**
  * Build the static protocol injected as cacheable system context.
  * v0.2: imperative, step-by-step with examples.
@@ -57,20 +62,4 @@ export declare function getNearBaselineThreshold(mode?: PsycheMode): number;
  * - No protocol (LLM doesn't need system internals)
  * - <psyche_update> only for empathy (not chemistry — already computed)
  */
-export declare function buildCompactContext(state: PsycheState, userId?: string, opts?: {
-    userText?: string;
-    algorithmStimulus?: string | null;
-    personalityIntensity?: number;
-    channelType?: ChannelType;
-    metacognitiveNote?: string;
-    decisionContext?: string;
-    ethicsContext?: string;
-    sharedIntentionalityContext?: string;
-    experientialNarrative?: string;
-    autonomicDescription?: string;
-    autonomicState?: AutonomicState;
-    primarySystemsDescription?: string;
-    subjectivityContext?: string;
-    responseContractContext?: string;
-    policyContext?: string;
-}): string;
+export declare function buildCompactContext(state: PsycheState, userId?: string, opts?: PromptRenderInputs): string;

package/dist/prompt.js

@@ -11,6 +11,50 @@ import { buildDriveContext, hasCriticalDrive } from "./drives.js";
 import { computeSelfReflection, buildSelfReflectionContext } from "./self-recognition.js";
 import { gateEmotions } from "./autonomic.js";
 import { getChannelProfile, buildChannelModifier } from "./channels.js";
+function pushLabeledSection(parts, locale, titleZh, titleEn, content) {
+    if (!content)
+        return;
+    parts.push("", `[${locale === "zh" ? titleZh : titleEn}] ${content}`);
+}
+function pushRawSection(parts, content) {
+    if (!content)
+        return;
+    parts.push("", content);
+}
+function appendDynamicOverlaySections(parts, locale, opts) {
+    pushLabeledSection(parts, locale, "元认知", "Metacognition", opts?.metacognitiveNote);
+    pushLabeledSection(parts, locale, "决策倾向", "Decision Bias", opts?.decisionContext);
+    pushLabeledSection(parts, locale, "内在体验", "Inner Experience", opts?.experientialNarrative);
+    pushRawSection(parts, opts?.sharedIntentionalityContext);
+    pushRawSection(parts, opts?.ethicsContext);
+    pushLabeledSection(parts, locale, "自主神经状态", "Autonomic State", opts?.autonomicDescription);
+    pushLabeledSection(parts, locale, "行为倾向", "Behavioral Tendencies", opts?.primarySystemsDescription);
+    pushRawSection(parts, opts?.policyContext);
+}
+function appendCompactOverlaySections(parts, locale, opts) {
+    if (opts?.metacognitiveNote && !(opts?.responseContractContext && isNeutralMetacognitiveNote(opts.metacognitiveNote))) {
+        pushLabeledSection(parts, locale, "元认知", "Metacognition", opts.metacognitiveNote);
+    }
+    if (opts?.decisionContext && !opts?.subjectivityContext) {
+        pushLabeledSection(parts, locale, "决策倾向", "Decision Bias", opts.decisionContext);
+    }
+    if (opts?.experientialNarrative && !opts?.subjectivityContext) {
+        pushLabeledSection(parts, locale, "内在体验", "Inner Experience", opts.experientialNarrative);
+    }
+    if (opts?.sharedIntentionalityContext && !(opts?.responseContractContext && isGenericSharedIntentionalityContext(opts.sharedIntentionalityContext))) {
+        pushRawSection(parts, opts.sharedIntentionalityContext);
+    }
+    pushRawSection(parts, opts?.ethicsContext);
+    if (opts?.autonomicDescription && !opts?.subjectivityContext) {
+        pushLabeledSection(parts, locale, "自主神经", "Autonomic", opts.autonomicDescription);
+    }
+    if (opts?.primarySystemsDescription && !opts?.subjectivityContext) {
+        pushLabeledSection(parts, locale, "行为倾向", "Tendencies", opts.primarySystemsDescription);
+    }
+    if (opts?.policyContext && !opts?.subjectivityContext) {
+        pushRawSection(parts, opts.policyContext);
+    }
+}
 /**
  * Build the dynamic per-turn emotional context injected via before_prompt_build.
  *
@@ -98,42 +142,7 @@ export function buildDynamicContext(state, userId, opts) {
     if (reciprocity) {
         parts.push("", reciprocity);
     }
-    // Metacognitive awareness (P5)
-    if (opts?.metacognitiveNote) {
-        const mcTitle = locale === "zh" ? "元认知" : "Metacognition";
-        parts.push("", `[${mcTitle}] ${opts.metacognitiveNote}`);
-    }
-    // Decision bias context (P5)
-    if (opts?.decisionContext) {
-        const dbTitle = locale === "zh" ? "决策倾向" : "Decision Bias";
-        parts.push("", `[${dbTitle}] ${opts.decisionContext}`);
-    }
-    // Experiential field narrative (P6)
-    if (opts?.experientialNarrative) {
-        const efTitle = locale === "zh" ? "内在体验" : "Inner Experience";
-        parts.push("", `[${efTitle}] ${opts.experientialNarrative}`);
-    }
-    // Shared intentionality (P6)
-    if (opts?.sharedIntentionalityContext) {
-        parts.push("", opts.sharedIntentionalityContext);
-    }
-    // Ethics (P6)
-    if (opts?.ethicsContext) {
-        parts.push("", opts.ethicsContext);
-    }
-    // Autonomic state (P7)
-    if (opts?.autonomicDescription) {
-        const anTitle = locale === "zh" ? "自主神经状态" : "Autonomic State";
-        parts.push("", `[${anTitle}] ${opts.autonomicDescription}`);
-    }
-    // Primary systems behavioral tendencies (P9)
-    if (opts?.primarySystemsDescription) {
-        const psTitle = locale === "zh" ? "行为倾向" : "Behavioral Tendencies";
-        parts.push("", `[${psTitle}] ${opts.primarySystemsDescription}`);
-    }
-    if (opts?.policyContext) {
-        parts.push("", opts.policyContext);
-    }
+    appendDynamicOverlaySections(parts, locale, opts);
     parts.push("", agencyReminder, sycophancyWarning, "", t("dynamic.update_reminder", locale));
     return parts.filter((l) => l !== undefined).join("\n");
 }
@@ -468,8 +477,8 @@ function buildMirrorConstraints(userText, locale) {
 function buildCompactSensingContext(_userText, locale, algorithmStimulus) {
     if (locale === "zh") {
         return algorithmStimulus
-            ? `[情绪感知] 算法初判:${algorithmStimulus}，仅供参考；按真实感受终判语气。`
-            : `[情绪感知] 这句的情绪基调由你终判。`;
+            ? `[情绪感知] 算法初判:${algorithmStimulus}；你终判。`
+            : `[情绪感知] 情绪由你终判。`;
     }
     return algorithmStimulus
         ? `[Emotional Sensing] Algorithm hint: ${algorithmStimulus}; final tonal read is yours.`
@@ -804,49 +813,7 @@ export function buildCompactContext(state, userId, opts) {
         if (selfCtx)
             parts.push(selfCtx);
     }
-    // 9. Metacognitive awareness (P5)
-    if (opts?.metacognitiveNote && !(opts?.responseContractContext && isNeutralMetacognitiveNote(opts.metacognitiveNote))) {
-        parts.push(locale === "zh"
-            ? `[元认知] ${opts.metacognitiveNote}`
-            : `[Metacognition] ${opts.metacognitiveNote}`);
-    }
-    // 9b. Decision/autonomic/policy are compressed into subjectivityContext
-    // when available. Keep legacy renderers for compatibility.
-    if (opts?.decisionContext && !opts?.subjectivityContext) {
-        parts.push(locale === "zh"
-            ? `[决策倾向] ${opts.decisionContext}`
-            : `[Decision Bias] ${opts.decisionContext}`);
-    }
-    // 9c. Experiential field narrative (P6) — inner experience beyond named emotions
-    if (opts?.experientialNarrative && !opts?.subjectivityContext) {
-        parts.push(locale === "zh"
-            ? `[内在体验] ${opts.experientialNarrative}`
-            : `[Inner Experience] ${opts.experientialNarrative}`);
-    }
-    // 9d. Shared intentionality (P6) — theory of mind, joint attention
-    if (opts?.sharedIntentionalityContext && !(opts?.responseContractContext && isGenericSharedIntentionalityContext(opts.sharedIntentionalityContext))) {
-        parts.push(opts.sharedIntentionalityContext);
-    }
-    // 9e. Ethics (P6) — manipulation detection, self-protection
-    if (opts?.ethicsContext) {
-        parts.push(opts.ethicsContext);
-    }
-    // 9f. Autonomic state (P7) — polyvagal nervous system state
-    if (opts?.autonomicDescription && !opts?.subjectivityContext) {
-        parts.push(locale === "zh"
-            ? `[自主神经] ${opts.autonomicDescription}`
-            : `[Autonomic] ${opts.autonomicDescription}`);
-    }
-    // 9g. Primary systems behavioral tendencies (P9)
-    if (opts?.primarySystemsDescription && !opts?.subjectivityContext) {
-        parts.push(locale === "zh"
-            ? `[行为倾向] ${opts.primarySystemsDescription}`
-            : `[Tendencies] ${opts.primarySystemsDescription}`);
-    }
-    // 9h. Policy context (v9)
-    if (opts?.policyContext && !opts?.subjectivityContext) {
-        parts.push(opts.policyContext);
-    }
+    appendCompactOverlaySections(parts, locale, opts);
     // 10. Channel modifier — expression style per platform
     if (opts?.channelType) {
         const channelProfile = getChannelProfile(opts.channelType);

package/dist/psyche-file.d.ts

@@ -1,4 +1,4 @@
-import type { PsycheState, MBTIType, ChemicalState, RelationshipState, Locale, StimulusType, ChemicalSnapshot } from "./types.js";
+import type { PsycheState, MBTIType, ChemicalState, RelationshipState, Locale, StimulusType, ChemicalSnapshot, WritebackSignalType } from "./types.js";
 export interface SemanticTurnSummary {
     summary: string;
     points?: string[];
@@ -93,6 +93,10 @@ export interface PsycheUpdateResult {
     state: Partial<PsycheState>;
     /** LLM-assisted stimulus classification (when algorithm was uncertain) */
     llmStimulus?: StimulusType;
+    /** Sparse agent-authored writeback signals */
+    signals?: WritebackSignalType[];
+    /** Optional writeback confidence */
+    signalConfidence?: number;
 }
 /**
  * Parse a <psyche_update> block from LLM output.

package/dist/psyche-file.js

@@ -710,10 +710,42 @@ export function parsePsycheUpdate(text, logger = NOOP_LOGGER) {
             llmStimulus = candidate;
         }
     }
+    const VALID_WRITEBACK_SIGNALS = new Set([
+        "trust_up",
+        "trust_down",
+        "boundary_set",
+        "boundary_soften",
+        "repair_attempt",
+        "repair_landed",
+        "closeness_invite",
+        "withdrawal_mark",
+        "self_assertion",
+        "task_recenter",
+    ]);
+    let signals;
+    const signalsMatch = block.match(/signals\s*[:：]\s*([^\n]+)/i);
+    if (signalsMatch) {
+        const parsed = signalsMatch[1]
+            .split(/[,\s|]+/)
+            .map((item) => item.trim())
+            .filter(Boolean)
+            .filter((item) => VALID_WRITEBACK_SIGNALS.has(item));
+        if (parsed.length > 0) {
+            signals = [...new Set(parsed)];
+        }
+    }
+    let signalConfidence;
+    const signalConfidenceMatch = block.match(/(?:signalConfidence|signalsConfidence|signal_confidence)\s*[:：]\s*([\d.]+)/i);
+    if (signalConfidenceMatch) {
+        const parsed = parseFloat(signalConfidenceMatch[1]);
+        if (isFinite(parsed)) {
+            signalConfidence = Math.max(0, Math.min(1, parsed));
+        }
+    }
     // Parse relationship updates
     const trustMatch = block.match(/(?:信任度|trust)\s*[:：]\s*(\d+)/i);
     const intimacyMatch = block.match(/(?:亲密度|intimacy)\s*[:：]\s*(\d+)/i);
-    if (Object.keys(updates).length === 0 && !empathyLog && !trustMatch && !llmStimulus) {
+    if (Object.keys(updates).length === 0 && !empathyLog && !trustMatch && !llmStimulus && !signals) {
         logger.debug(t("log.parse_debug", "zh", { snippet: block.slice(0, 100) }));
         return null;
     }
@@ -738,6 +770,12 @@ export function parsePsycheUpdate(text, logger = NOOP_LOGGER) {
     if (llmStimulus) {
         result.llmStimulus = llmStimulus;
     }
+    if (signals) {
+        result.signals = signals;
+    }
+    if (signalConfidence !== undefined) {
+        result.signalConfidence = signalConfidence;
+    }
     return result;
 }
 /**

package/dist/relation-dynamics.d.ts

@@ -1,4 +1,4 @@
-import type { PendingRelationSignalState, AppraisalAxes, DyadicFieldState, PsycheState, RelationshipState, ResolvedRelationContext, PsycheMode, RelationMove, StimulusType } from "./types.js";
+import type { PendingRelationSignalState, AppraisalAxes, DyadicFieldState, PendingWritebackCalibration, PsycheState, RelationshipState, ResolvedRelationContext, PsycheMode, RelationMove, SessionBridgeState, StimulusType, WritebackCalibrationFeedback, WritebackSignalType } from "./types.js";
 export declare function computeRelationMove(text: string, opts?: {
     appraisal?: AppraisalAxes;
     stimulus?: StimulusType | null;
@@ -7,6 +7,27 @@ export declare function computeRelationMove(text: string, opts?: {
     relationship?: RelationshipState;
 }): RelationMove;
 export declare function resolveRelationContext(state: PsycheState, userId?: string): ResolvedRelationContext;
+export declare function applySessionBridge(state: PsycheState, opts?: {
+    userId?: string;
+    now?: string;
+}): {
+    state: PsycheState;
+    bridge: SessionBridgeState | null;
+};
+export declare function createWritebackCalibrations(state: PsycheState, signals: WritebackSignalType[], opts?: {
+    userId?: string;
+    confidence?: number;
+    now?: string;
+}): PendingWritebackCalibration[];
+export declare function evaluateWritebackCalibrations(state: PsycheState): {
+    state: PsycheState;
+    feedback: WritebackCalibrationFeedback[];
+};
+export declare function applyWritebackSignals(state: PsycheState, signals: WritebackSignalType[], opts?: {
+    userId?: string;
+    confidence?: number;
+    now?: string;
+}): PsycheState;
 export declare function applyRelationalTurn(state: PsycheState, text: string, opts: {
     mode?: PsycheMode;
     now?: string;