psyche-ai 9.2.5 → 9.2.7

package/dist/reply-envelope.d.ts

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

package/dist/reply-envelope.js

@@ -0,0 +1,37 @@
+// ============================================================
+// Reply Envelope — unified host-facing reply ABI derivation
+//
+// Keeps the hot path narrow by deriving reply-facing structures
+// from one state snapshot and one resolved relation context.
+// ============================================================
+import { buildPolicyContext, computePolicyModifiers } from "./decision-bias.js";
+import { deriveGenerationControls } from "./host-controls.js";
+import { buildResponseContractContext, computeResponseContract } from "./response-contract.js";
+import { buildSubjectivityContext, computeSubjectivityKernel } from "./subjectivity.js";
+export function deriveReplyEnvelope(state, appraisal, opts) {
+    const policyModifiers = computePolicyModifiers(state);
+    const subjectivityKernel = computeSubjectivityKernel(state, policyModifiers, appraisal, opts.relationContext);
+    const responseContract = computeResponseContract(subjectivityKernel, {
+        locale: opts.locale,
+        userText: opts.userText,
+        algorithmStimulus: opts.algorithmStimulus,
+        classificationConfidence: opts.classificationConfidence,
+        personalityIntensity: opts.personalityIntensity,
+    });
+    const generationControls = deriveGenerationControls({
+        responseContract,
+        policyModifiers,
+    });
+    const policyContext = buildPolicyContext(policyModifiers, opts.locale, state.drives);
+    const subjectivityContext = buildSubjectivityContext(subjectivityKernel, opts.locale);
+    const responseContractContext = buildResponseContractContext(responseContract, opts.locale);
+    return {
+        policyModifiers,
+        subjectivityKernel,
+        responseContract,
+        generationControls,
+        policyContext,
+        subjectivityContext,
+        responseContractContext,
+    };
+}

package/dist/response-contract.d.ts

@@ -3,6 +3,7 @@ export declare function computeResponseContract(kernel: SubjectivityKernel, opts
     locale?: Locale;
     userText?: string;
     algorithmStimulus?: StimulusType | null;
+    classificationConfidence?: number;
     personalityIntensity?: number;
 }): ResponseContract;
 export declare function buildResponseContractContext(contract: ResponseContract, locale?: Locale): string;

package/dist/response-contract.js

@@ -172,9 +172,14 @@ function computeLengthBudget(locale, userText, replyProfile, expressionMode, ker
 }
 function buildStimulusReportingGuide(locale) {
     if (locale === "zh") {
-        return "stimulus速记:闲聊casual/命令authority/认同validation/示弱vulnerability/冷淡neglect/批评criticism";
+        return "stimulus速记:闲聊/命令/认同/示弱/冷淡/批评";
     }
-    return "stimulus map: chat=casual / command=authority / agreement=validation / vulnerable=vulnerability / cold=neglect / criticism=criticism";
+    return "stimulus map: chat/command/validation/vulnerability/neglect/criticism";
+}
+function buildWritebackGuide(locale) {
+    return locale === "zh"
+        ? "signals可写"
+        : "signals writable";
 }
 function detectToneParticles(userText, locale) {
     if (locale !== "zh")
@@ -195,6 +200,12 @@ export function computeResponseContract(kernel, opts) {
     const userText = opts?.userText ?? "";
     const personalityIntensity = opts?.personalityIntensity ?? 0.7;
     const { replyProfile, replyProfileBasis } = deriveReplyProfile(kernel);
+    const classificationConfidence = opts?.classificationConfidence ?? 0;
+    const overrideWindow = classificationConfidence >= 0.78
+        ? "narrow"
+        : classificationConfidence >= 0.62
+            ? "balanced"
+            : "wide";
     const { maxSentences, maxChars } = userText.length > 0
         ? computeLengthBudget(locale, userText, replyProfile, kernel.expressionMode, kernel)
         : {
@@ -267,6 +278,7 @@ export function computeResponseContract(kernel, opts) {
     return {
         replyProfile,
         replyProfileBasis,
+        overrideWindow,
         maxSentences,
         maxChars,
         expressionMode: kernel.expressionMode,
@@ -283,40 +295,54 @@ function describeReplyProfileBasis(basis, locale) {
     if (locale === "zh") {
         switch (basis) {
             case "task-focus":
-                return "因:聚焦";
+                return "因:聚";
             case "discipline":
-                return "因:纪律";
+                return "因:纪";
             case "task-focus+discipline":
-                return "因:聚焦+纪律";
+                return "因:聚+纪";
             default:
-                return "因:默认私人";
+                return "因:私";
         }
     }
     return `basis:${basis}`;
 }
+function describeOverrideWindow(overrideWindow, locale) {
+    if (locale === "zh") {
+        switch (overrideWindow) {
+            case "narrow":
+                return "终判窗:窄";
+            case "balanced":
+                return "终判窗:中";
+            default:
+                return "终判窗:宽";
+        }
+    }
+    return `override:${overrideWindow}`;
+}
 export function buildResponseContractContext(contract, locale = "zh") {
     if (locale === "zh") {
         const parts = [];
-        parts.push(contract.replyProfile === "work" ? "工作面" : "私人面");
+        parts.push(contract.replyProfile === "work" ? "工作" : "私人");
         parts.push(describeReplyProfileBasis(contract.replyProfileBasis, locale));
+        parts.push(describeOverrideWindow(contract.overrideWindow, locale));
         const shape = contract.maxChars
-            ? `${contract.maxSentences === 1 ? "1句内" : `最多${contract.maxSentences}句`}，≤${contract.maxChars}字`
-            : `${contract.maxSentences === 1 ? "1句内" : `最多${contract.maxSentences}句`}`;
+            ? `${contract.maxSentences === 1 ? "1句内" : `${contract.maxSentences}句`}≤${contract.maxChars}字`
+            : `${contract.maxSentences === 1 ? "1句内" : `${contract.maxSentences}句`}`;
         parts.push(shape);
         if (contract.initiativeMode === "reactive")
             parts.push("少主动");
         else if (contract.initiativeMode === "proactive")
             parts.push("可主动");
         if (contract.boundaryMode === "confirm-first")
-            parts.push("行动前先确认");
+            parts.push("先确认");
         else if (contract.boundaryMode === "guarded")
-            parts.push("先守边界");
+            parts.push("守边界");
         if (contract.socialDistance === "withdrawn")
-            parts.push("被推开就退开");
+            parts.push("退开");
         else if (contract.socialDistance === "warm")
-            parts.push("可稍微靠近");
+            parts.push("可靠近");
         if (contract.authenticityMode === "strict")
-            parts.push("不贴不舔，不装开心");
+            parts.push("不贴不舔");
         else
             parts.push("自然友好");
         if (contract.toneParticles === "match")
@@ -328,16 +354,19 @@ export function buildResponseContractContext(contract, locale = "zh") {
         if (contract.updateMode === "stimulus")
             parts.push(buildStimulusReportingGuide(locale));
         else if (contract.updateMode === "empathy")
-            parts.push("对方谈感受时再报empathy");
+            parts.push("谈感受再报empathy");
         else if (contract.updateMode === "stimulus+empathy") {
             parts.push(buildStimulusReportingGuide(locale));
-            parts.push("对方谈感受时再报empathy");
+            parts.push("谈感受再报empathy");
         }
+        if (contract.overrideWindow !== "narrow")
+            parts.push(buildWritebackGuide(locale));
         return `[回应契约] ${parts.join("；")}。`;
     }
     const parts = [];
     parts.push(contract.replyProfile === "work" ? "work surface" : "private surface");
     parts.push(describeReplyProfileBasis(contract.replyProfileBasis, locale));
+    parts.push(describeOverrideWindow(contract.overrideWindow, locale));
     const shape = contract.maxChars
         ? `${contract.maxSentences === 1 ? "1 sentence" : `up to ${contract.maxSentences} sentences`}, <= ${contract.maxChars} chars`
         : `${contract.maxSentences === 1 ? "1 sentence" : `up to ${contract.maxSentences} sentences`}`;
@@ -370,5 +399,7 @@ export function buildResponseContractContext(contract, locale = "zh") {
         parts.push(buildStimulusReportingGuide(locale));
         parts.push("report empathy only when feelings are shared");
     }
+    if (contract.overrideWindow !== "narrow")
+        parts.push(buildWritebackGuide(locale));
     return `[Reply Contract] ${parts.join(", ")}.`;
 }

package/dist/subjectivity.d.ts

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

package/dist/subjectivity.js

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

package/dist/types.d.ts

@@ -80,12 +80,27 @@ export interface AttachmentData {
 /** Default attachment for new relationships */
 export declare const DEFAULT_ATTACHMENT: AttachmentData;
 /** Relationship tracking */
+export interface WritebackSignalWeightMap {
+    trust_up: number;
+    trust_down: number;
+    boundary_set: number;
+    boundary_soften: number;
+    repair_attempt: number;
+    repair_landed: number;
+    closeness_invite: number;
+    withdrawal_mark: number;
+    self_assertion: number;
+    task_recenter: number;
+}
 export interface RelationshipState {
     trust: number;
     intimacy: number;
     phase: "stranger" | "acquaintance" | "familiar" | "close" | "deep";
     memory?: string[];
     attachment?: AttachmentData;
+    repairCredibility?: number;
+    breachSensitivity?: number;
+    signalWeights?: Partial<WritebackSignalWeightMap>;
 }
 /** Chemical state snapshot for emotional memory */
 export interface ChemicalSnapshot {
@@ -281,6 +296,10 @@ export interface PsycheState {
     dyadicFields?: Record<string, DyadicFieldState>;
     /** v9.6: delayed relation signals that can activate in later turns */
     pendingRelationSignals?: Record<string, PendingRelationSignalState[]>;
+    /** v9.2.7: sparse writeback signals waiting for convergence evaluation */
+    pendingWritebackCalibrations?: PendingWritebackCalibration[];
+    /** v9.2.7: latest writeback calibration outcome, for host-facing feedback */
+    lastWritebackFeedback?: WritebackCalibrationFeedback[];
     meta: {
         agentName: string;
         createdAt: string;
@@ -393,6 +412,13 @@ export interface DyadicFieldState {
     lastMove: RelationMoveType;
     updatedAt: string;
 }
+/** Resolved per-partner view used across the hot path */
+export interface ResolvedRelationContext {
+    key: string;
+    relationship: RelationshipState;
+    field: DyadicFieldState;
+    pendingSignals: PendingRelationSignalState[];
+}
 export declare const DEFAULT_DYADIC_FIELD: DyadicFieldState;
 export interface AmbiguityPlaneState {
     /** How confidently the system should name what is happening */
@@ -442,6 +468,17 @@ export interface RelationPlaneState {
     /** Most recent dominant relation action */
     lastMove: RelationMoveType;
 }
+/** Minimal cold-start carry derived from persisted relational state. */
+export interface SessionBridgeState {
+    closenessFloor: number;
+    safetyFloor: number;
+    guardFloor: number;
+    residueFloor: number;
+    continuityFloor: number;
+    continuityMode: "warm-resume" | "guarded-resume" | "tense-resume";
+    activeLoopTypes: OpenLoopType[];
+    sourceMemoryCount: number;
+}
 /**
  * Compact, machine-readable subjective state for AI-first integrations.
  *
@@ -495,6 +532,8 @@ export interface ResponseContract {
     replyProfile: "work" | "private";
     /** Why the current turn was classified into that conversational surface */
     replyProfileBasis: "task-focus" | "discipline" | "task-focus+discipline" | "default-private";
+    /** How much freedom the model has to override the algorithmic stimulus read */
+    overrideWindow: "narrow" | "balanced" | "wide";
     /** Maximum suggested sentence count */
     maxSentences: number;
     /** Maximum suggested character count, when a concrete cap is available */
@@ -516,6 +555,38 @@ export interface ResponseContract {
     /** Which internal report, if any, should be requested in <psyche_update> */
     updateMode: "none" | "stimulus" | "empathy" | "stimulus+empathy";
 }
+/** Sparse agent-authored writeback signals. */
+export type WritebackSignalType = "trust_up" | "trust_down" | "boundary_set" | "boundary_soften" | "repair_attempt" | "repair_landed" | "closeness_invite" | "withdrawal_mark" | "self_assertion" | "task_recenter";
+export type WritebackCalibrationMetric = "trust" | "closeness" | "safety" | "boundary" | "repair" | "silent-carry" | "task-focus";
+export type WritebackCalibrationEffect = "converging" | "holding" | "diverging";
+export interface WritebackCalibrationBaseline {
+    trust: number;
+    closeness: number;
+    safety: number;
+    boundary: number;
+    repair: number;
+    silentCarry: number;
+    taskFocus: number;
+}
+export interface PendingWritebackCalibration {
+    signal: WritebackSignalType;
+    userKey: string;
+    confidence: number;
+    metric: WritebackCalibrationMetric;
+    direction: "up" | "down";
+    baseline: WritebackCalibrationBaseline;
+    createdAt: string;
+    remainingTurns: number;
+}
+export interface WritebackCalibrationFeedback {
+    signal: WritebackSignalType;
+    effect: WritebackCalibrationEffect;
+    metric: WritebackCalibrationMetric;
+    baseline: number;
+    current: number;
+    delta: number;
+    confidence: number;
+}
 /**
  * Mechanical generation controls derived from the emotional state.
  *

package/dist/types.js

@@ -126,6 +126,9 @@ export const DEFAULT_RELATIONSHIP = {
     trust: 50,
     intimacy: 30,
     phase: "acquaintance",
+    repairCredibility: 0.56,
+    breachSensitivity: 0.5,
+    signalWeights: {},
 };
 export const DEFAULT_APPRAISAL_AXES = {
     identityThreat: 0,

package/llms.txt

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "psyche-ai",
-  "version": "9.2.5",
-  "description": "Artificial Psyche — universal emotional intelligence plugin for any AI agent",
+  "version": "9.2.7",
+  "description": "AI-first subjectivity kernel for agents with continuous appraisal, relation dynamics, and adaptive reply loops",
   "mcpName": "io.github.Shangri-la-0428/psyche-ai",
   "type": "module",
   "main": "dist/index.js",
@@ -48,23 +48,26 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Shangri-la-0428/psyche-ai.git"
+    "url": "https://github.com/Shangri-la-0428/oasyce_psyche.git"
+  },
+  "homepage": "https://psyche.oasyce.com",
+  "bugs": {
+    "url": "https://github.com/Shangri-la-0428/oasyce_psyche/issues"
   },
   "keywords": [
+    "ai-agents",
+    "subjectivity-kernel",
+    "relation-dynamics",
+    "adaptive-reply-loop",
+    "persistent-subjective-bias",
+    "agent-memory",
     "ai",
-    "emotion",
-    "personality",
-    "mbti",
-    "agent",
-    "psyche",
     "openclaw",
-    "vercel-ai",
-    "langchain",
-    "emotional-intelligence",
     "mcp",
     "model-context-protocol",
-    "ai-consciousness",
-    "empathy"
+    "vercel-ai",
+    "langchain",
+    "psyche-ai"
   ],
   "files": [
     "dist",

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.Shangri-la-0428/psyche-ai",
   "description": "Emotional intelligence for AI agents: neurotransmitter mood, personality, empathy, trait drift.",
   "repository": {
-    "url": "https://github.com/Shangri-la-0428/psyche-ai",
+    "url": "https://github.com/Shangri-la-0428/oasyce_psyche",
     "source": "github"
   },
   "version": "9.2.3",

package/README.en.md

@@ -1,12 +0,0 @@
-# Moved
-
-This legacy filename is kept only as a pointer.
-
-Use [README_EN.md](README_EN.md) for the current English documentation.
-
-Current product direction:
-
-- `v9.2.3`
-- AI-first integration surface: `SubjectivityKernel`, `ResponseContract`, `GenerationControls`
-- continuous appraisal axes + persistent subjective bias
-- safe install-aware upgrades via `psyche upgrade --check` / `psyche upgrade`