psyche-ai 11.3.1 → 11.4.0

package/README.md

@@ -291,6 +291,22 @@ cd oasyce_psyche && npm install && npx tsx examples/quickstart.ts
 
 稳态是有限的、可打破的。溶解螺旋（序↓界↓正反馈）= 个体"死亡"。长期偏移导致基线漂移（异稳态）= 个体"适应"。
 
+### Overlay — 自我状态的广播信号（v11.4）
+
+4 维自我状态对外部系统来说太"内部"了。`computeOverlay()` 把状态偏差投影成 4 个语义稳定的效应信号——Psyche 的"激素"：
+
+```typescript
+import { computeOverlay } from "psyche-ai";
+
+const overlay = computeOverlay(engine.getState());
+// overlay.arousal        [-1, 1]  激活水平
+// overlay.valence        [-1, 1]  正负效价
+// overlay.agency         [-1, 1]  行动能力
+// overlay.vulnerability  [-1, 1]  易感性
+```
+
+纯函数，无副作用。也可以通过 `GET /overlay`（HTTP）或 `get_state`（MCP）获取。
+
 ### 持续主体偏置（v9.2）
 
 Psyche 现在更准确的目标，不是“模仿某种像人的风格”，而是让 AI 形成**持续主体偏置**：

package/dist/adapters/http.js

@@ -9,12 +9,14 @@
 // Endpoints:
 //   POST /process-input  { text, userId? }  → { systemContext, dynamicContext, stimulus, replyEnvelope?, ...compat aliases, sessionBridge?, writebackFeedback?, externalContinuity?, throngletsExports?, policyContext }
 //   POST /process-output { text, userId?, signals?, signalConfidence? }  → { cleanedText, stateChanged }
-//   GET  /state                             → PsycheState
+//   GET  /state                             → PsycheState + overlay
+//   GET  /overlay                           → PsycheOverlay (arousal/valence/agency/vulnerability)
 //   GET  /protocol?locale=zh                → { protocol }
 //
 // Zero dependencies — uses node:http only.
 // ============================================================
 import { createServer } from "node:http";
+import { computeOverlay } from "../overlay.js";
 const VALID_WRITEBACK_SIGNALS = new Set([
     "trust_up",
     "trust_down",
@@ -68,7 +70,14 @@ export function createPsycheServer(engine, opts) {
             const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
             // GET /state
             if (req.method === "GET" && url.pathname === "/state") {
-                json(res, 200, engine.getState());
+                const state = engine.getState();
+                json(res, 200, { ...state, overlay: computeOverlay(state) });
+                return;
+            }
+            // GET /overlay
+            if (req.method === "GET" && url.pathname === "/overlay") {
+                const state = engine.getState();
+                json(res, 200, computeOverlay(state));
                 return;
             }
             // GET /protocol

package/dist/adapters/mcp.js

@@ -201,6 +201,8 @@ server.tool("get_state", "Get the current emotional state — self-state dimensi
     const eng = await getEngine();
     const state = eng.getState();
     const summary = eng.getStatusSummary();
+    const { computeOverlay } = await import("../overlay.js");
+    const overlay = computeOverlay({ current: state.current, baseline: state.baseline });
     return {
         content: [{
                 type: "text",
@@ -208,6 +210,7 @@ server.tool("get_state", "Get the current emotional state — self-state dimensi
                     summary,
                     current: state.current,
                     baseline: state.baseline,
+                    overlay,
                     drives: state.drives,
                     mbti: state.mbti,
                     mode: state.meta?.mode,

package/dist/index.d.ts

@@ -16,5 +16,7 @@ export { getBaseline, getSensitivity, getDefaultSelfModel, getTemperament, trait
 export { createCustomProfile, PRESET_PROFILES } from "./custom-profile.js";
 export { LLMExpressionAdapter } from "./reply-envelope.js";
 export type { ExpressionPort, ExpressionOutput, ReplyEnvelope } from "./reply-envelope.js";
+export { computeOverlay, OVERLAY_KEYS } from "./overlay.js";
+export type { PsycheOverlay } from "./overlay.js";
 export { computeLayerHealthSummary } from "./diagnostics.js";
 export type { LayerHealthSummary, LayerHealthDetail, LayerStatus, DiagnosticLayer } from "./diagnostics.js";

package/dist/index.js

@@ -33,6 +33,8 @@ export { getBaseline, getSensitivity, getDefaultSelfModel, getTemperament, trait
 export { createCustomProfile, PRESET_PROFILES } from "./custom-profile.js";
 // ── Expression ──────────────────────────────────────────────
 export { LLMExpressionAdapter } from "./reply-envelope.js";
+// ── Overlay (effect signals for external consumers) ─────────
+export { computeOverlay, OVERLAY_KEYS } from "./overlay.js";
 // ── Diagnostics ─────────────────────────────────────────────
 export { computeLayerHealthSummary } from "./diagnostics.js";
 // ============================================================

package/dist/overlay.d.ts

@@ -0,0 +1,39 @@
+import type { SelfState } from "./types.js";
+/**
+ * Semantic-stable effect signals derived from 4D self-state.
+ *
+ * All values [-1, 1]. 0 = at baseline (no effect).
+ */
+export interface PsycheOverlay {
+    /** Activation level. High flow + disrupted order = high arousal. */
+    arousal: number;
+    /** Positive/negative quality. High order + high resonance = positive. */
+    valence: number;
+    /** Capacity for intentional action. High boundary + high flow. */
+    agency: number;
+    /** Susceptibility to perturbation. Low boundary + low order. */
+    vulnerability: number;
+}
+/** Overlay dimension keys for iteration. */
+export declare const OVERLAY_KEYS: (keyof PsycheOverlay)[];
+/**
+ * Project self-state into overlay effect signals.
+ *
+ * Pure linear projection from dimension deviations:
+ *
+ * ```
+ *                    order   flow   boundary  resonance
+ * arousal        = [ -0.4    0.6     0         0       ]
+ * valence        = [  0.5    0       0         0.5     ]
+ * agency         = [  0      0.4     0.6       0       ]
+ * vulnerability  = [ -0.4    0      -0.6       0       ]
+ * ```
+ *
+ * Each signal reads exactly 2 dimensions. Sparse and interpretable.
+ * arousal/valence are the classic activation×evaluation axes;
+ * agency/vulnerability reflect structural integrity.
+ */
+export declare function computeOverlay(state: {
+    current: SelfState;
+    baseline: SelfState;
+}): PsycheOverlay;

package/dist/overlay.js

@@ -0,0 +1,51 @@
+// ============================================================
+// Overlay — semantic-stable effect signals for external consumers
+//
+// The overlay is a projection of self-state, not an interface adapter.
+// arousal/valence/agency/vulnerability have meaning independent of
+// any consumer. Psyche secretes these like hormones — broadcast,
+// not point-to-point.
+// ============================================================
+/** Overlay dimension keys for iteration. */
+export const OVERLAY_KEYS = [
+    "arousal", "valence", "agency", "vulnerability",
+];
+/**
+ * Normalization range. A 50-point deviation from baseline maps to full scale.
+ *
+ * Dimensions are 0-100, so ±50 is the theoretical max. In practice most
+ * deviations are ±20 (overlay ~±0.4), keeping the signal informative.
+ */
+const RANGE = 50;
+/**
+ * Project self-state into overlay effect signals.
+ *
+ * Pure linear projection from dimension deviations:
+ *
+ * ```
+ *                    order   flow   boundary  resonance
+ * arousal        = [ -0.4    0.6     0         0       ]
+ * valence        = [  0.5    0       0         0.5     ]
+ * agency         = [  0      0.4     0.6       0       ]
+ * vulnerability  = [ -0.4    0      -0.6       0       ]
+ * ```
+ *
+ * Each signal reads exactly 2 dimensions. Sparse and interpretable.
+ * arousal/valence are the classic activation×evaluation axes;
+ * agency/vulnerability reflect structural integrity.
+ */
+export function computeOverlay(state) {
+    const c = state.current;
+    const b = state.baseline;
+    const dO = (c.order - b.order) / RANGE;
+    const dF = (c.flow - b.flow) / RANGE;
+    const dB = (c.boundary - b.boundary) / RANGE;
+    const dR = (c.resonance - b.resonance) / RANGE;
+    const clamp = (v) => Math.max(-1, Math.min(1, v)) || 0;
+    return {
+        arousal: clamp(-0.4 * dO + 0.6 * dF),
+        valence: clamp(0.5 * dO + 0.5 * dR),
+        agency: clamp(0.4 * dF + 0.6 * dB),
+        vulnerability: clamp(-0.4 * dO - 0.6 * dB),
+    };
+}

package/llms.txt

@@ -146,6 +146,21 @@ await psyche.processResponse(text);
 - `generationControls`
 - `writebackFeedback`
 
+### Overlay (v11.4)
+
+`computeOverlay(state)` projects 4D self-state deviations into 4 semantic-stable effect signals — Psyche's "hormones." These are broadcast signals any external system can consume without coupling to Psyche internals.
+
+```typescript
+interface PsycheOverlay {
+  arousal: number;       // [-1, 1] activation level (flow↑ + order↓)
+  valence: number;       // [-1, 1] positive/negative (order↑ + resonance↑)
+  agency: number;        // [-1, 1] action capacity (boundary↑ + flow↑)
+  vulnerability: number; // [-1, 1] susceptibility (boundary↓ + order↓)
+}
+```
+
+Pure function, no side effects. Exported from `psyche-ai` public API. Also available via `GET /overlay` (HTTP adapter) and `get_state` MCP tool (overlay field included in response).
+
 ### MCP tools
 
 - `process_input`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "psyche-ai",
-  "version": "11.3.1",
+  "version": "11.4.0",
   "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",