psyche-ai 11.3.1 → 11.5.0

package/README.md

@@ -1,7 +1,7 @@
 # Psyche — 赋予 AI 自我的主观性内核
 
 [![npm](https://img.shields.io/npm/v/psyche-ai)](https://www.npmjs.com/package/psyche-ai)
-[![tests](https://img.shields.io/badge/tests-1427%20passing-brightgreen)]()
+[![tests](https://img.shields.io/badge/tests-1433%20passing-brightgreen)]()
 [![deps](https://img.shields.io/badge/dependencies-0-blue)]()
 [![license](https://img.shields.io/badge/license-MIT-yellow)](LICENSE)
 
@@ -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 形成**持续主体偏置**：
@@ -562,7 +578,7 @@ Psyche 核心引擎永久开源（MIT）。
 ```bash
 npm install
 npm run build
-npm test           # 1427 tests
+npm test           # 1433 tests
 npm run typecheck  # strict mode
 ```
 

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

@@ -39,7 +39,8 @@ const NAME = process.env.PSYCHE_NAME ?? "Assistant";
 const MODE = (process.env.PSYCHE_MODE ?? "natural");
 const LOCALE = (process.env.PSYCHE_LOCALE ?? "en");
 const PERSIST = process.env.PSYCHE_PERSIST !== "false";
-const WORKSPACE = process.env.PSYCHE_WORKSPACE ?? process.cwd();
+const SIGIL_ID = process.env.PSYCHE_SIGIL_ID ?? undefined;
+const BASE_WORKSPACE = process.env.PSYCHE_WORKSPACE ?? process.cwd();
 const INTENSITY = process.env.PSYCHE_INTENSITY
     ? Number(process.env.PSYCHE_INTENSITY)
     : 0.7;
@@ -70,6 +71,10 @@ function parseCLIArgs() {
             overrides.personalityIntensity = Number(next);
             i++;
         }
+        else if (arg === "--sigil-id" && next) {
+            overrides.sigilId = next;
+            i++;
+        }
         else if (arg === "--no-persist") {
             overrides.persist = false;
         }
@@ -82,19 +87,23 @@ async function getEngine() {
     if (engine)
         return engine;
     const cliArgs = parseCLIArgs();
+    const sigilId = cliArgs.sigilId ?? SIGIL_ID;
     const cfg = {
         mbti: cliArgs.mbti ?? MBTI,
         name: cliArgs.name ?? NAME,
         mode: cliArgs.mode ?? MODE,
         locale: cliArgs.locale ?? LOCALE,
+        sigilId,
         personalityIntensity: cliArgs.personalityIntensity ?? INTENSITY,
         persist: cliArgs.persist ?? PERSIST,
         compactMode: true,
         diagnostics: true,
     };
     const persist = cfg.persist !== false;
+    // Per-Sigil workspace isolation: each Sigil gets its own state directory
+    const workspace = sigilId ? `${BASE_WORKSPACE}/${sigilId}` : BASE_WORKSPACE;
     const storage = persist
-        ? new FileStorageAdapter(WORKSPACE)
+        ? new FileStorageAdapter(workspace)
         : new MemoryStorageAdapter();
     engine = new PsycheEngine(cfg, storage);
     await engine.initialize();
@@ -103,7 +112,7 @@ async function getEngine() {
 // ── MCP Server ─────────────────────────────────────────────
 const server = new McpServer({
     name: "psyche",
-    version: "9.2.3",
+    version: "11.4.0",
 }, {
     capabilities: {
         resources: {},
@@ -201,6 +210,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 +219,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/core.d.ts

@@ -6,6 +6,8 @@ export interface PsycheEngineConfig {
     mbti?: MBTIType;
     name?: string;
     locale?: Locale;
+    /** Sigil ID — which Loop this Psyche instance serves. When set, state persists per-Sigil. */
+    sigilId?: string;
     stripUpdateTags?: boolean;
     emotionalContagionRate?: number;
     maxDimensionDelta?: number;

package/dist/core.js

@@ -146,6 +146,7 @@ export class PsycheEngine {
             mbti: config.mbti ?? "INFJ",
             name: config.name ?? "agent",
             locale: config.locale ?? "zh",
+            sigilId: config.sigilId,
             stripUpdateTags: config.stripUpdateTags ?? true,
             emotionalContagionRate: config.emotionalContagionRate ?? 0.2,
             maxDimensionDelta: config.maxDimensionDelta ?? 25,
@@ -221,6 +222,10 @@ export class PsycheEngine {
             if (!loaded.lastWritebackFeedback) {
                 loaded.lastWritebackFeedback = [];
             }
+            // Update sigilId if config provides one (Sigil may be assigned after first run)
+            if (this.cfg.sigilId && loaded.meta.sigilId !== this.cfg.sigilId) {
+                loaded.meta = { ...loaded.meta, sigilId: this.cfg.sigilId };
+            }
             this.state = loaded;
         }
         else {
@@ -825,6 +830,7 @@ export class PsycheEngine {
                 totalInteractions: 0,
                 locale,
                 mode: this.cfg.mode,
+                ...(this.cfg.sigilId ? { sigilId: this.cfg.sigilId } : {}),
             },
         };
     }
@@ -892,6 +898,7 @@ export class PsycheEngine {
         const driveWarning = hungryDrives.length > 0
             ? ` | \u26A0\uFE0F${hungryDrives.join(",")}`
             : "";
-        return `${emoji} ${emotion} | flow:${Math.round(flow)} order:${Math.round(order)}${driveWarning}`;
+        const sigilTag = state.meta.sigilId ? ` | sigil:${state.meta.sigilId}` : "";
+        return `${emoji} ${emotion} | flow:${Math.round(flow)} order:${Math.round(order)}${driveWarning}${sigilTag}`;
     }
 }

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/dist/thronglets-export.js

@@ -45,6 +45,29 @@ function updateExportState(state, keys, now) {
         throngletsExportState: nextState,
     };
 }
+function quantize(v, step = 10) {
+    return Math.round(v / step) * step;
+}
+function selfStateSummary(o, f, b, r) {
+    const parts = [];
+    if (o > 65)
+        parts.push("structured");
+    else if (o < 35)
+        parts.push("chaotic");
+    if (f > 65)
+        parts.push("flowing");
+    else if (f < 35)
+        parts.push("stuck");
+    if (b > 65)
+        parts.push("open");
+    else if (b < 35)
+        parts.push("guarded");
+    if (r > 65)
+        parts.push("attuned");
+    else if (r < 35)
+        parts.push("dissonant");
+    return parts.length > 0 ? parts.join(", ") : "neutral";
+}
 function sanitizeThrongletsExport(event) {
     switch (event.kind) {
         case "relation-milestone": {
@@ -108,6 +131,23 @@ function sanitizeThrongletsExport(event) {
             };
             return sanitized;
         }
+        case "self-state": {
+            const sanitized = {
+                kind: "self-state",
+                subject: "session",
+                primitive: "signal",
+                userKey: event.userKey,
+                strength: event.strength,
+                ttlTurns: event.ttlTurns,
+                key: event.key,
+                order: event.order,
+                flow: event.flow,
+                boundary: event.boundary,
+                resonance: event.resonance,
+                summary: event.summary,
+            };
+            return sanitized;
+        }
     }
 }
 export function deriveThrongletsExports(state, opts) {
@@ -166,6 +206,20 @@ export function deriveThrongletsExports(state, opts) {
             silentCarry: field.silentCarry,
         });
     }
+    // Self-state — sparse, only emits when dimensions shift by ≥10
+    const { order, flow, boundary, resonance } = state.current;
+    const selfKey = `self-state:O${quantize(order)}:F${quantize(flow)}:B${quantize(boundary)}:R${quantize(resonance)}`;
+    candidates.push({
+        kind: "self-state",
+        subject: "session",
+        primitive: "signal",
+        userKey,
+        strength: 0.5,
+        ttlTurns: 12,
+        key: selfKey,
+        order, flow, boundary, resonance,
+        summary: selfStateSummary(order, flow, boundary, resonance),
+    });
     for (const feedback of writebackFeedback) {
         if (feedback.effect === "holding")
             continue;

package/dist/thronglets-runtime.js

@@ -3,6 +3,7 @@ const TAXONOMY_BY_EVENT = {
     "open-loop-anchor": "coordination",
     "continuity-anchor": "continuity",
     "writeback-calibration": "calibration",
+    "self-state": "state",
 };
 function summarizeLoopTypes(loopTypes) {
     return loopTypes.join(", ");
@@ -19,6 +20,8 @@ function summarizeThrongletsExport(event) {
             const calibration = event;
             return `writeback calibration ${calibration.signal} ${calibration.effect} on ${calibration.metric}`;
         }
+        case "self-state":
+            return event.summary;
     }
 }
 export function taxonomyForThrongletsExport(event) {

package/dist/types.d.ts

@@ -374,6 +374,8 @@ export interface PsycheState {
         totalInteractions: number;
         locale: Locale;
         mode?: PsycheMode;
+        /** Sigil ID — which Loop this Psyche instance serves */
+        sigilId?: string;
     };
 }
 /** Default relationship for new users */
@@ -560,7 +562,7 @@ export interface SessionBridgeState {
 export type ThrongletsExportSubject = "delegate" | "session";
 export type ThrongletsExportPrimitive = "signal" | "trace";
 export interface ThrongletsExportBase {
-    kind: "relation-milestone" | "open-loop-anchor" | "writeback-calibration" | "continuity-anchor";
+    kind: "relation-milestone" | "open-loop-anchor" | "writeback-calibration" | "continuity-anchor" | "self-state";
     subject: ThrongletsExportSubject;
     primitive: ThrongletsExportPrimitive;
     userKey: string;
@@ -601,7 +603,17 @@ export interface ContinuityAnchorExport extends ThrongletsExportBase {
     activeLoopTypes: OpenLoopType[];
     continuityFloor: number;
 }
-export type ThrongletsExport = RelationMilestoneExport | OpenLoopAnchorExport | WritebackCalibrationExport | ContinuityAnchorExport;
+export interface SelfStateExport extends ThrongletsExportBase {
+    kind: "self-state";
+    subject: "session";
+    primitive: "signal";
+    order: number;
+    flow: number;
+    boundary: number;
+    resonance: number;
+    summary: string;
+}
+export type ThrongletsExport = RelationMilestoneExport | OpenLoopAnchorExport | WritebackCalibrationExport | ContinuityAnchorExport | SelfStateExport;
 export interface ThrongletsExportState {
     lastKeys: string[];
     lastAt: string;
@@ -615,7 +627,7 @@ export interface ExternalContinuityEnvelope<TEvent = ExternalContinuityEvent> {
     signals: TEvent[];
     traces: TEvent[];
 }
-export type ThrongletsTraceTaxonomy = "coordination" | "continuity" | "calibration";
+export type ThrongletsTraceTaxonomy = "coordination" | "continuity" | "calibration" | "state";
 export interface ThrongletsExternalContinuityRecord {
     provider: "thronglets";
     mode: "optional";

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.5.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",