psyche-ai 9.2.6 → 9.2.7

package/dist/adapters/http.js

@@ -8,13 +8,31 @@
 //
 // Endpoints:
 //   POST /process-input  { text, userId? }  → { systemContext, dynamicContext, stimulus, policyModifiers?, subjectivityKernel?, responseContract?, generationControls?, policyContext }
-//   POST /process-output { text, userId? }  → { cleanedText, stateChanged }
+//   POST /process-output { text, userId?, signals?, signalConfidence? }  → { cleanedText, stateChanged }
 //   GET  /state                             → PsycheState
 //   GET  /protocol?locale=zh                → { protocol }
 //
 // Zero dependencies — uses node:http only.
 // ============================================================
 import { createServer } from "node:http";
+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",
+]);
+function parseSignals(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const parsed = value.filter((item) => (typeof item === "string" && VALID_WRITEBACK_SIGNALS.has(item)));
+    return parsed.length > 0 ? [...new Set(parsed)] : undefined;
+}
 // ── Server ───────────────────────────────────────────────────
 /**
  * Create an HTTP server that exposes PsycheEngine via REST API.
@@ -69,7 +87,11 @@ export function createPsycheServer(engine, opts) {
             // POST /process-output
             if (req.method === "POST" && url.pathname === "/process-output") {
                 const body = await readBody(req);
-                const result = await engine.processOutput(body.text ?? "", { userId: body.userId });
+                const result = await engine.processOutput(body.text ?? "", {
+                    userId: body.userId,
+                    signals: parseSignals(body.signals),
+                    signalConfidence: typeof body.signalConfidence === "number" ? body.signalConfidence : undefined,
+                });
                 json(res, 200, result);
                 return;
             }

package/dist/adapters/langchain.d.ts

@@ -28,6 +28,8 @@ import type { PsycheEngine } from "../core.js";
 export declare class PsycheLangChain {
     private readonly engine;
     constructor(engine: PsycheEngine);
+    private readonly validSignals;
+    private parseSignals;
     /**
      * Get the system message to inject into the LLM call.
      * Combines the protocol (cacheable) and dynamic context (per-turn).
@@ -59,5 +61,7 @@ export declare class PsycheLangChain {
      */
     processResponse(text: string, opts?: {
         userId?: string;
+        signals?: string[];
+        signalConfidence?: number;
     }): Promise<string>;
 }

package/dist/adapters/langchain.js

@@ -43,6 +43,24 @@ export class PsycheLangChain {
     constructor(engine) {
         this.engine = engine;
     }
+    validSignals = new Set([
+        "trust_up",
+        "trust_down",
+        "boundary_set",
+        "boundary_soften",
+        "repair_attempt",
+        "repair_landed",
+        "closeness_invite",
+        "withdrawal_mark",
+        "self_assertion",
+        "task_recenter",
+    ]);
+    parseSignals(signals) {
+        if (!signals)
+            return undefined;
+        const parsed = signals.filter((signal) => this.validSignals.has(signal));
+        return parsed.length > 0 ? [...new Set(parsed)] : undefined;
+    }
     /**
      * Get the system message to inject into the LLM call.
      * Combines the protocol (cacheable) and dynamic context (per-turn).
@@ -80,7 +98,11 @@ export class PsycheLangChain {
      * Call this AFTER the LLM invocation, before showing output to the user.
      */
     async processResponse(text, opts) {
-        const result = await this.engine.processOutput(text, opts);
+        const result = await this.engine.processOutput(text, {
+            userId: opts?.userId,
+            signals: this.parseSignals(opts?.signals),
+            signalConfidence: opts?.signalConfidence,
+        });
         return result.cleanedText;
     }
 }

package/dist/adapters/mcp.js

@@ -174,9 +174,11 @@ server.tool("process_output", "Process the LLM's response through the emotional
     "emotional contagion. Call this AFTER generating a response.", {
     text: z.string().describe("The LLM's response text"),
     userId: z.string().optional().describe("Optional user ID"),
-}, async ({ text, userId }) => {
+    signals: z.array(z.string()).optional().describe("Optional sparse writeback signals from the host"),
+    signalConfidence: z.number().min(0).max(1).optional().describe("Optional confidence for the supplied signals"),
+}, async ({ text, userId, signals, signalConfidence }) => {
     const eng = await getEngine();
-    const result = await eng.processOutput(text, { userId });
+    const result = await eng.processOutput(text, { userId, signals: signals, signalConfidence });
     return {
         content: [{
                 type: "text",

package/dist/core.d.ts

@@ -1,4 +1,4 @@
-import type { PsycheState, StimulusType, Locale, MBTIType, OutcomeScore, PsycheMode, PersonalityTraits, PolicyModifiers, ClassifierProvider, SubjectivityKernel, ResponseContract, GenerationControls } from "./types.js";
+import type { PsycheState, StimulusType, Locale, MBTIType, OutcomeScore, PsycheMode, PersonalityTraits, PolicyModifiers, ClassifierProvider, SubjectivityKernel, ResponseContract, GenerationControls, SessionBridgeState, WritebackCalibrationFeedback, WritebackSignalType } from "./types.js";
 import type { StorageAdapter } from "./storage.js";
 import type { DiagnosticReport, SessionMetrics } from "./diagnostics.js";
 export interface PsycheEngineConfig {
@@ -36,6 +36,8 @@ export interface ProcessInputResult {
     dynamicContext: string;
     /** Detected stimulus type from user input, null if none */
     stimulus: StimulusType | null;
+    /** Confidence of the primary algorithmic stimulus guess, if any */
+    stimulusConfidence?: number;
     /** v9: Structured behavioral policy modifiers — machine-readable "off baseline" signals */
     policyModifiers?: PolicyModifiers;
     /** v9.3: Compact machine-readable subjective state for AI-first hosts */
@@ -44,6 +46,10 @@ export interface ProcessInputResult {
     responseContract?: ResponseContract;
     /** v9.3: Mechanical host controls derived from the reply envelope */
     generationControls?: GenerationControls;
+    /** v9.2.7: cold-start carry derived from persisted relation state */
+    sessionBridge?: SessionBridgeState | null;
+    /** v9.2.8: sparse writeback signals evaluated on the latest turn */
+    writebackFeedback?: WritebackCalibrationFeedback[];
     /**
      * v9: Ready-to-use LLM prompt fragment summarizing current behavioral policy.
      *
@@ -65,6 +71,11 @@ export interface ProcessOutputResult {
     /** Whether chemistry was meaningfully updated (contagion or psyche_update) */
     stateChanged: boolean;
 }
+export interface ProcessOutputOptions {
+    userId?: string;
+    signals?: WritebackSignalType[];
+    signalConfidence?: number;
+}
 export interface ProcessOutcomeResult {
     /** Outcome evaluation score (-1 to 1) */
     outcomeScore: OutcomeScore;
@@ -89,6 +100,8 @@ export declare class PsycheEngine {
     private lastReport;
     /** URL for auto-submitting diagnostic reports */
     private readonly feedbackUrl;
+    /** Most recent algorithmic stimulus read + confidence band */
+    private lastStimulusAssessment;
     constructor(config: PsycheEngineConfig | undefined, storage: StorageAdapter);
     /**
      * Load or create initial state. Must be called before processInput/processOutput.
@@ -105,9 +118,7 @@ export declare class PsycheEngine {
      * Phase 2: Process LLM output text.
      * Parses <psyche_update> tags, applies contagion, strips tags.
      */
-    processOutput(text: string, opts?: {
-        userId?: string;
-    }): Promise<ProcessOutputResult>;
+    processOutput(text: string, opts?: ProcessOutputOptions): Promise<ProcessOutputResult>;
     /**
      * Phase 3 (optional): Explicitly evaluate the outcome of the last interaction.
      *

package/dist/core.js

@@ -32,8 +32,18 @@ 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 { applyRelationalTurn } from "./relation-dynamics.js";
+import { applyRelationalTurn, applySessionBridge, applyWritebackSignals, createWritebackCalibrations, evaluateWritebackCalibrations } from "./relation-dynamics.js";
 import { deriveReplyEnvelope } from "./reply-envelope.js";
+function formatWritebackFeedbackNote(feedback, locale) {
+    const top = feedback?.[0];
+    if (!top)
+        return undefined;
+    if (locale === "zh") {
+        const effect = top.effect === "converging" ? "收敛" : top.effect === "diverging" ? "发散" : "持平";
+        return `写回:${top.signal} ${effect}。`;
+    }
+    return `Writeback: ${top.signal} ${top.effect}.`;
+}
 const NOOP_LOGGER = { info: () => { }, warn: () => { }, debug: () => { } };
 const REPAIRING_STIMULI = new Set(["praise", "validation", "intimacy"]);
 const RELATIONSHIP_DELTAS = {
@@ -127,6 +137,8 @@ export class PsycheEngine {
     lastReport = null;
     /** URL for auto-submitting diagnostic reports */
     feedbackUrl;
+    /** Most recent algorithmic stimulus read + confidence band */
+    lastStimulusAssessment = null;
     constructor(config = {}, storage) {
         this.traits = config.traits;
         this.classifier = config.classifier ?? new BuiltInClassifier();
@@ -204,6 +216,12 @@ export class PsycheEngine {
             if (!loaded.pendingRelationSignals) {
                 loaded.pendingRelationSignals = { _default: [] };
             }
+            if (!loaded.pendingWritebackCalibrations) {
+                loaded.pendingWritebackCalibrations = [];
+            }
+            if (!loaded.lastWritebackFeedback) {
+                loaded.lastWritebackFeedback = [];
+            }
             this.state = loaded;
         }
         else {
@@ -219,6 +237,8 @@ export class PsycheEngine {
      */
     async processInput(text, opts) {
         let state = this.ensureInitialized();
+        let sessionBridge = null;
+        let writebackFeedback = [];
         // ── Auto-learning: evaluate previous turn's outcome ──────
         if (this.pendingPrediction && text.length > 0) {
             const nextClassifications = classifyStimulus(text);
@@ -261,6 +281,9 @@ export class PsycheEngine {
         }
         // P12: Track session start for homeostatic pressure
         if (!state.sessionStartedAt) {
+            const bridged = applySessionBridge(state, { userId: opts?.userId, now: now.toISOString() });
+            state = bridged.state;
+            sessionBridge = bridged.bridge;
             state = { ...state, sessionStartedAt: now.toISOString() };
         }
         // Apply homeostatic pressure (fatigue from extended sessions)
@@ -311,6 +334,7 @@ export class PsycheEngine {
                 }
             }
             const primary = classifications[0];
+            const primaryConfidence = primary?.confidence ?? 0;
             let current = state.current;
             if (primary && primary.confidence >= 0.5) {
                 appliedStimulus = primary.type;
@@ -334,6 +358,18 @@ export class PsycheEngine {
             if (appliedStimulus) {
                 state = applyRelationshipDrift(state, appliedStimulus, opts?.userId);
             }
+            this.lastStimulusAssessment = {
+                stimulus: primary?.type ?? null,
+                confidence: primaryConfidence,
+                overrideWindow: primaryConfidence >= 0.78 ? "narrow" : primaryConfidence >= 0.62 ? "balanced" : "wide",
+            };
+        }
+        else {
+            this.lastStimulusAssessment = {
+                stimulus: null,
+                confidence: 0,
+                overrideWindow: "wide",
+            };
         }
         // v9: Deplete energy budgets from this interaction turn
         energyBudgets = computeEnergyDepletion(energyBudgets, appliedStimulus, isExtravert);
@@ -361,6 +397,9 @@ export class PsycheEngine {
                 },
             };
         }
+        const writebackEvaluation = evaluateWritebackCalibrations(state);
+        state = writebackEvaluation.state;
+        writebackFeedback = writebackEvaluation.feedback;
         // ── Locale (used by multiple subsystems below) ──────────
         const locale = state.meta.locale ?? this.cfg.locale;
         // ── P7+P10: Autonomic nervous system + Processing depth ────
@@ -517,7 +556,10 @@ export class PsycheEngine {
             this.diagnosticCollector.recordInput(appliedStimulus, appliedStimulus ? 1.0 : 0.0, state.current, appraisalAxes);
         }
         // Build metacognitive and decision context strings
-        const metacogNote = metacognitiveAssessment?.metacognitiveNote;
+        const writebackNote = formatWritebackFeedbackNote(writebackFeedback, locale);
+        const metacogNote = writebackNote
+            ? [writebackNote, metacognitiveAssessment?.metacognitiveNote].filter(Boolean).join("\n")
+            : metacognitiveAssessment?.metacognitiveNote;
         const decisionCtx = buildDecisionContext(state);
         const ethicsCtx = ethicalAssessment ? buildEthicalContext(ethicalAssessment, locale) : undefined;
         const sharedCtx = sharedState ? buildSharedIntentionalityContext(sharedState, locale) : undefined;
@@ -527,6 +569,7 @@ export class PsycheEngine {
             locale,
             userText: text || undefined,
             algorithmStimulus: appliedStimulus,
+            classificationConfidence: this.lastStimulusAssessment?.confidence,
             personalityIntensity: this.cfg.personalityIntensity,
             relationContext: relationalTurn.relationContext,
         });
@@ -561,10 +604,13 @@ export class PsycheEngine {
                     policyContext: replyEnvelope.policyContext || undefined,
                 }),
                 stimulus: appliedStimulus,
+                stimulusConfidence: this.lastStimulusAssessment?.confidence,
                 policyModifiers: replyEnvelope.policyModifiers,
                 subjectivityKernel: replyEnvelope.subjectivityKernel,
                 responseContract: replyEnvelope.responseContract,
                 generationControls: replyEnvelope.generationControls,
+                sessionBridge,
+                writebackFeedback,
                 policyContext: replyEnvelope.policyContext,
             };
         }
@@ -582,10 +628,13 @@ export class PsycheEngine {
                 policyContext: replyEnvelope.policyContext || undefined,
             }),
             stimulus: appliedStimulus,
+            stimulusConfidence: this.lastStimulusAssessment?.confidence,
             policyModifiers: replyEnvelope.policyModifiers,
             subjectivityKernel: replyEnvelope.subjectivityKernel,
             responseContract: replyEnvelope.responseContract,
             generationControls: replyEnvelope.generationControls,
+            sessionBridge,
+            writebackFeedback,
             policyContext: replyEnvelope.policyContext,
         };
     }
@@ -645,6 +694,8 @@ export class PsycheEngine {
         // Anti-sycophancy: track agreement streak
         state = updateAgreementStreak(state, text);
         // Parse and merge <psyche_update> from LLM output
+        let combinedSignals = [];
+        let combinedSignalConfidence = opts?.signalConfidence;
         if (text.includes("<psyche_update>")) {
             const parseResult = parsePsycheUpdate(text, NOOP_LOGGER);
             if (parseResult) {
@@ -652,7 +703,8 @@ export class PsycheEngine {
                 stateChanged = true;
                 // LLM-assisted classification: if algorithm didn't apply a stimulus
                 // but LLM classified one, retroactively apply chemistry + drives
-                if (parseResult.llmStimulus && !this._lastAlgorithmApplied) {
+                const overrideAllowed = this.lastStimulusAssessment?.overrideWindow !== "narrow";
+                if (parseResult.llmStimulus && (!this._lastAlgorithmApplied || overrideAllowed)) {
                     state = {
                         ...state,
                         drives: feedDrives(state.drives, parseResult.llmStimulus),
@@ -660,11 +712,38 @@ export class PsycheEngine {
                     const effectiveSensitivity = computeEffectiveSensitivity(getSensitivity(state.mbti), state.drives, parseResult.llmStimulus, state.traitDrift);
                     state = {
                         ...state,
-                        current: applyStimulus(state.current, parseResult.llmStimulus, effectiveSensitivity, this.cfg.maxChemicalDelta, NOOP_LOGGER),
+                        current: applyStimulus(state.current, parseResult.llmStimulus, effectiveSensitivity * (overrideAllowed && this._lastAlgorithmApplied ? 0.8 : 1), this.cfg.maxChemicalDelta, NOOP_LOGGER),
                     };
                 }
+                if (parseResult.signals && parseResult.signals.length > 0) {
+                    combinedSignals.push(...parseResult.signals);
+                    combinedSignalConfidence = Math.max(combinedSignalConfidence ?? 0, parseResult.signalConfidence ?? 0);
+                }
             }
         }
+        if (opts?.signals && opts.signals.length > 0) {
+            combinedSignals.push(...opts.signals);
+            combinedSignalConfidence = Math.max(combinedSignalConfidence ?? 0, opts.signalConfidence ?? 0);
+        }
+        if (combinedSignals.length > 0) {
+            const dedupedSignals = [...new Set(combinedSignals)];
+            const pending = createWritebackCalibrations(state, dedupedSignals, {
+                userId: opts?.userId,
+                confidence: combinedSignalConfidence,
+            });
+            state = applyWritebackSignals(state, dedupedSignals, {
+                userId: opts?.userId,
+                confidence: combinedSignalConfidence,
+            });
+            state = {
+                ...state,
+                pendingWritebackCalibrations: [
+                    ...(state.pendingWritebackCalibrations ?? []),
+                    ...pending,
+                ].slice(-12),
+            };
+            stateChanged = true;
+        }
         // Persist
         this.state = state;
         await this.storage.save(state);
@@ -850,6 +929,8 @@ export class PsycheEngine {
                 },
             },
             pendingRelationSignals: { _default: [] },
+            pendingWritebackCalibrations: [],
+            lastWritebackFeedback: [],
             meta: {
                 agentName: name,
                 createdAt: now,
@@ -889,6 +970,8 @@ export class PsycheEngine {
                 },
             },
             pendingRelationSignals: { _default: [] },
+            pendingWritebackCalibrations: [],
+            lastWritebackFeedback: [],
             relationships: opts?.preserveRelationships !== false
                 ? state.relationships
                 : { _default: { ...DEFAULT_RELATIONSHIP } },

package/dist/index.d.ts

@@ -2,7 +2,7 @@ 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, SubjectivityKernel, ResponseContract, GenerationControls, AppraisalAxes, SubjectResidue, TaskPlaneState, SubjectPlaneState, RelationPlaneState, AmbiguityPlaneState, RelationMoveType, RelationMove, OpenLoopType, OpenLoopState, PendingRelationSignalState, DyadicFieldState, TraitDriftState, EnergyBudgets, ClassifierProvider, ClassifierContext, ClassificationResult, } 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, SessionBridgeState, WritebackSignalType, WritebackSignalWeightMap, PendingWritebackCalibration, WritebackCalibrationFeedback, WritebackCalibrationMetric, 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";
@@ -27,7 +27,7 @@ export { computeSubjectivityKernel, buildSubjectivityContext } from "./subjectiv
 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 { computeRelationMove, evolveDyadicField, evolvePendingRelationSignals, getLoopPressure, applySessionBridge, applyWritebackSignals, createWritebackCalibrations, evaluateWritebackCalibrations, } 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

@@ -38,7 +38,7 @@ export { computeSubjectivityKernel, buildSubjectivityContext } from "./subjectiv
 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 { computeRelationMove, evolveDyadicField, evolvePendingRelationSignals, getLoopPressure, applySessionBridge, applyWritebackSignals, createWritebackCalibrations, evaluateWritebackCalibrations, } 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.js

@@ -468,8 +468,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.`

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;