psyche-ai 10.2.3 → 11.2.0

package/dist/circadian.js

@@ -1,18 +1,6 @@
 // ============================================================
-// Artificial Psyche — Circadian Rhythm Module
+// Circadian Rhythm — v11: modulates 4 self-state dimensions
 // ============================================================
-// Applies time-of-day modulation to virtual neurochemistry,
-// modeling the body's ~24-hour biological clock and fatigue
-// from extended sessions (homeostatic pressure).
-// ============================================================
-/**
- * Classify a time into a circadian phase.
- *   morning:   6–9
- *   midday:    10–13
- *   afternoon: 14–17
- *   evening:   18–21
- *   night:     22–5
- */
 export function getCircadianPhase(time) {
     const h = time.getHours();
     if (h >= 6 && h <= 9)
@@ -26,47 +14,33 @@ export function getCircadianPhase(time) {
     return "night";
 }
 // ── Sinusoidal Helpers ───────────────────────────────────────
-/** Convert hour (0-23) + minute to fractional hours */
 function fractionalHour(time) {
     return time.getHours() + time.getMinutes() / 60;
 }
-/**
- * Sinusoidal modulation: amplitude * cos(2π(t - peak) / 24)
- * Returns value in [-amplitude, +amplitude], peaking at `peakHour`.
- */
 function sinMod(t, peakHour, amplitude) {
     const phase = ((t - peakHour) / 24) * 2 * Math.PI;
     return amplitude * Math.cos(phase);
 }
-// ── Circadian Modulation ─────────────────────────────────────
+// ── Circadian Modulation (4D) ───────────────────────────────
 /**
- * Apply circadian rhythm modulation to baseline chemistry.
- *
- * Each chemical follows a sinusoidal daily curve:
- *   CORT — peaks ~8am, amplitude ±8
- *   HT   — peaks ~13 (daytime high), amplitude ±5
- *   DA   — slight afternoon peak ~14, amplitude ±3
- *   NE   — morning rise ~10, amplitude ±5
- *   END  — evening rise ~20, amplitude ±3
- *   OT   — evening warmth ~20, amplitude ±2
+ * Apply circadian rhythm modulation to baseline self-state.
  *
- * All results clamped to [0, 100].
+ *   order     — peaks ~13 (midday coherence), amplitude ±5
+ *   flow      — peaks ~10 (morning engagement), amplitude ±5
+ *   boundary  — peaks ~8 (morning clarity), amplitude ±3
+ *   resonance — peaks ~20 (evening warmth), amplitude ±3
  */
 export function computeCircadianModulation(currentTime, baseline) {
     const t = fractionalHour(currentTime);
-    const cortDelta = sinMod(t, 8, 8);
-    const htDelta = sinMod(t, 13, 5);
-    const daDelta = sinMod(t, 14, 3);
-    const neDelta = sinMod(t, 10, 5);
-    const endDelta = sinMod(t, 20, 3);
-    const otDelta = sinMod(t, 20, 2);
+    const orderDelta = sinMod(t, 13, 5);
+    const flowDelta = sinMod(t, 10, 5);
+    const boundaryDelta = sinMod(t, 8, 3);
+    const resonanceDelta = sinMod(t, 20, 3);
     return {
-        DA: clamp(baseline.DA + daDelta),
-        HT: clamp(baseline.HT + htDelta),
-        CORT: clamp(baseline.CORT + cortDelta),
-        OT: clamp(baseline.OT + otDelta),
-        NE: clamp(baseline.NE + neDelta),
-        END: clamp(baseline.END + endDelta),
+        order: clamp(baseline.order + orderDelta),
+        flow: clamp(baseline.flow + flowDelta),
+        boundary: clamp(baseline.boundary + boundaryDelta),
+        resonance: clamp(baseline.resonance + resonanceDelta),
     };
 }
 function clamp(v, lo = 0, hi = 100) {
@@ -75,30 +49,21 @@ function clamp(v, lo = 0, hi = 100) {
 // ── Homeostatic Pressure ─────────────────────────────────────
 /**
  * Compute fatigue effects from extended session duration.
- *
- * Below 30 minutes: no pressure (grace period).
- * Beyond 30 min: logarithmic growth (diminishing returns).
- * All values non-negative.
+ * Now expressed as dimension effects instead of chemical deltas.
  */
 export function computeHomeostaticPressure(sessionMinutes) {
     if (sessionMinutes < 30) {
-        return { cortAccumulation: 0, daDepletion: 0, neDepletion: 0 };
+        return { orderDepletion: 0, flowDepletion: 0, boundaryStiffening: 0 };
     }
-    // Effective minutes beyond the grace period
     const effective = sessionMinutes - 30;
-    // Logarithmic growth → diminishing returns
-    // ln(1 + x) grows slowly; scale factors tuned so 1h ≈ moderate, 10h ≈ high but bounded
-    const base = Math.log1p(effective / 30); // ln(1 + effective/30)
+    const base = Math.log1p(effective / 30);
     return {
-        cortAccumulation: parseFloat((base * 4).toFixed(4)),
-        daDepletion: parseFloat((base * 3).toFixed(4)),
-        neDepletion: parseFloat((base * 2.5).toFixed(4)),
+        orderDepletion: parseFloat((base * 3.5).toFixed(4)),
+        flowDepletion: parseFloat((base * 3).toFixed(4)),
+        boundaryStiffening: parseFloat((base * 2).toFixed(4)),
     };
 }
-// ── Energy Budgets (v9) ─────────────────────────────────────
-// Finite cognitive/social resources that deplete during interaction.
-// Extraverts GAIN social energy from interaction; introverts LOSE it.
-/** Stimulus-specific attention costs (higher = more draining) */
+// ── Energy Budgets (unchanged — substrate-independent) ──────
 const ATTENTION_COSTS = {
     intellectual: 5,
     conflict: 5,
@@ -108,7 +73,6 @@ const ATTENTION_COSTS = {
     criticism: 3,
     surprise: 2,
 };
-/** Stimulus-specific decision costs */
 const DECISION_COSTS = {
     conflict: 4,
     authority: 4,
@@ -116,46 +80,22 @@ const DECISION_COSTS = {
     criticism: 2,
     sarcasm: 2,
 };
-/**
- * Deplete energy budgets from a single interaction turn.
- *
- * - Attention: -3/turn base, extra for intellectual/conflict
- * - Social energy: extraverts +2/turn (charging), introverts -3/turn (draining)
- * - Decision capacity: varies by stimulus complexity
- *
- * Extraverts can exceed 100 (up to 120 — "supercharged").
- */
 export function computeEnergyDepletion(budgets, stimulus, isExtravert) {
-    const extravertMax = 120;
-    const introvertMax = 100;
-    const max = isExtravert ? extravertMax : introvertMax;
-    // Attention: base -3, extra from stimulus
+    const max = isExtravert ? 120 : 100;
     const attentionCost = 3 + (stimulus ? (ATTENTION_COSTS[stimulus] ?? 0) : 0);
     const attention = clamp(budgets.attention - attentionCost, 0, 100);
-    // Social energy: E charges, I drains
     const socialDelta = isExtravert ? 2 : -3;
     const socialEnergy = clamp(budgets.socialEnergy + socialDelta, 0, max);
-    // Decision capacity: base -1, extra from stimulus
     const decisionCost = 1 + (stimulus ? (DECISION_COSTS[stimulus] ?? 0) : 0);
     const decisionCapacity = clamp(budgets.decisionCapacity - decisionCost, 0, 100);
     return { attention, socialEnergy, decisionCapacity };
 }
-/**
- * Recover energy budgets during absence (between sessions or long pauses).
- *
- * - Attention: +20/hour
- * - Social energy: extraverts -3/hour (drain when alone), introverts +15/hour (recharge)
- * - Decision capacity: +25/hour
- */
 export function computeEnergyRecovery(budgets, minutesElapsed, isExtravert) {
     if (minutesElapsed <= 0)
         return { ...budgets };
     const hours = minutesElapsed / 60;
-    const extravertMax = 120;
-    const introvertMax = 100;
-    const max = isExtravert ? extravertMax : introvertMax;
+    const max = isExtravert ? 120 : 100;
     const attention = clamp(budgets.attention + hours * 20, 0, 100);
-    // E drains alone, I recharges alone
     const socialDelta = isExtravert ? -3 * hours : 15 * hours;
     const socialEnergy = clamp(budgets.socialEnergy + socialDelta, 0, max);
     const decisionCapacity = clamp(budgets.decisionCapacity + hours * 25, 0, 100);

package/dist/cli.js

@@ -16,6 +16,7 @@
 //   psyche probe [--json]
 //   psyche profiles [--json] [--mbti TYPE]
 //   psyche setup [--name NAME] [--mbti TYPE] [--locale LOCALE] [--proxy --target URL] [--dry-run]
+//   psyche mcp [--mbti TYPE] [--name NAME]   Start MCP server (stdio)
 // ============================================================
 import { resolve, join } from "node:path";
 import { homedir } from "node:os";
@@ -27,8 +28,8 @@ import { generateReport, formatReport, toGitHubIssueBody } from "./diagnostics.j
 import { getBaseline, getTemperament, getSensitivity, getDefaultSelfModel, traitsToBaseline } from "./profiles.js";
 import { buildDynamicContext, buildProtocolContext } from "./prompt.js";
 import { t } from "./i18n.js";
-import { CHEMICAL_KEYS, CHEMICAL_NAMES_ZH, DRIVE_KEYS, DRIVE_NAMES_ZH } from "./types.js";
-import { isMBTIType, isChemicalKey, isLocale } from "./guards.js";
+import { DIMENSION_KEYS, DIMENSION_NAMES_ZH, DRIVE_KEYS, DRIVE_NAMES_ZH } from "./types.js";
+import { isMBTIType, isDimensionKey, isLocale } from "./guards.js";
 import { getPackageVersion, selfUpdate } from "./update.js";
 import { runRuntimeProbe } from "./runtime-probe.js";
 // ── Logger ───────────────────────────────────────────────────
@@ -50,14 +51,14 @@ function arrow(current, baseline) {
         return "\u2193";
     return "=";
 }
-function printChemistry(state) {
+function printState(state) {
     const { current, baseline } = state;
-    for (const key of CHEMICAL_KEYS) {
+    for (const key of DIMENSION_KEYS) {
         const val = Math.round(current[key]);
         const base = baseline[key];
         const a = arrow(val, base);
-        const label = `${key}`.padEnd(4);
-        const nameZh = CHEMICAL_NAMES_ZH[key].padEnd(6);
+        const label = `${key}`.padEnd(10);
+        const nameZh = DIMENSION_NAMES_ZH[key].padEnd(4);
         console.log(`  ${label} ${nameZh} ${bar(val)} ${String(val).padStart(3)} (base:${base} ${a})`);
     }
 }
@@ -143,7 +144,7 @@ async function cmdInit(dir, mbti, name, lang, mode, traits, _noPersist) {
         await saveState(absDir, state);
     }
     console.log(`\nPsyche initialized for ${state.meta.agentName}${state.mbti ? ` (preset: ${state.mbti})` : ""}\n`);
-    printChemistry(state);
+    printState(state);
     console.log(`\nFiles created:`);
     console.log(`  ${absDir}/psyche-state.json`);
     console.log(`  ${absDir}/PSYCHE.md`);
@@ -168,12 +169,12 @@ async function cmdStatus(dir, json, userId) {
     const hint = getExpressionHint(state.current, locale);
     const elapsed = ((Date.now() - new Date(state.updatedAt).getTime()) / 60000).toFixed(1);
     const baselineSummary = [
-        state.baseline.DA < 55 ? "introvert" : "extrovert",
-        state.baseline.DA > state.baseline.HT ? "intuitive" : "sensing",
-        state.baseline.OT >= 50 ? "feeling" : "thinking",
+        state.baseline.flow < 55 ? "introvert" : "extrovert",
+        state.baseline.flow > state.baseline.order ? "intuitive" : "sensing",
+        state.baseline.resonance >= 50 ? "feeling" : "thinking",
     ].join("/");
     console.log(`\n${state.meta.agentName} (${baselineSummary}) — ${emotion}\n`);
-    printChemistry(state);
+    printState(state);
     console.log();
     printDrives(state);
     printEmotions(state);
@@ -224,7 +225,7 @@ async function cmdDecay(dir) {
     const after = await decayAndSave(absDir, before);
     const elapsed = ((Date.now() - new Date(before.updatedAt).getTime()) / 60000).toFixed(1);
     console.log(`\nDecay applied (${elapsed} min elapsed)\n`);
-    for (const key of CHEMICAL_KEYS) {
+    for (const key of DIMENSION_KEYS) {
         const bVal = Math.round(before.current[key]);
         const aVal = Math.round(after.current[key]);
         if (bVal !== aVal) {
@@ -245,15 +246,15 @@ async function cmdUpdate(dir, updateJson, userId) {
     }
     // Validate keys using type guard
     for (const key of Object.keys(parsed)) {
-        if (!isChemicalKey(key)) {
-            die(`unknown chemical key: ${key}. Valid: ${CHEMICAL_KEYS.join(", ")}`);
+        if (!isDimensionKey(key)) {
+            die(`unknown dimension key: ${key}. Valid: ${DIMENSION_KEYS.join(", ")}`);
         }
     }
     const updates = { current: parsed };
     const merged = mergeUpdates(state, updates, 25, userId);
     await saveState(absDir, merged);
-    console.log(`\nChemistry updated for ${merged.meta.agentName}\n`);
-    printChemistry(merged);
+    console.log(`\nState updated for ${merged.meta.agentName}\n`);
+    printState(merged);
     console.log();
 }
 async function cmdReset(dir, full) {
@@ -265,14 +266,14 @@ async function cmdReset(dir, full) {
     state.empathyLog = null;
     state.agreementStreak = 0;
     state.lastDisagreement = null;
-    state.emotionalHistory = [];
+    state.stateHistory = [];
     if (full) {
         state.relationships = { _default: { trust: 50, intimacy: 30, phase: "acquaintance" } };
     }
     await saveState(absDir, state);
     await generatePsycheMd(absDir, state);
     console.log(`\n${state.meta.agentName} reset to baseline${full ? " [full reset including relationships]" : ""}\n`);
-    printChemistry(state);
+    printState(state);
     console.log();
 }
 function cmdProfiles(json, mbti) {
@@ -291,10 +292,10 @@ function cmdProfiles(json, mbti) {
         }
         console.log(`\n${upper} — ${temperament}\n`);
         console.log(`  Sensitivity: ${sensitivity}`);
-        for (const key of CHEMICAL_KEYS) {
+        for (const key of DIMENSION_KEYS) {
             const val = baseline[key];
-            const label = `${key}`.padEnd(4);
-            const nameZh = CHEMICAL_NAMES_ZH[key].padEnd(6);
+            const label = `${key}`.padEnd(10);
+            const nameZh = DIMENSION_NAMES_ZH[key].padEnd(4);
             console.log(`  ${label} ${nameZh} ${bar(val)} ${val}`);
         }
         console.log(`\n  Values: ${selfModel.values.join(", ")}`);
@@ -333,9 +334,8 @@ function cmdProfiles(json, mbti) {
             const bl = getBaseline(mbtiType);
             const temperament = getTemperament(mbtiType);
             const sens = getSensitivity(mbtiType);
-            console.log(`    ${t}  DA:${String(bl.DA).padStart(2)} HT:${String(bl.HT).padStart(2)} ` +
-                `CORT:${String(bl.CORT).padStart(2)} OT:${String(bl.OT).padStart(2)} ` +
-                `NE:${String(bl.NE).padStart(2)} END:${String(bl.END).padStart(2)}  ` +
+            console.log(`    ${t}  order:${String(bl.order).padStart(2)} flow:${String(bl.flow).padStart(2)} ` +
+                `boundary:${String(bl.boundary).padStart(2)} resonance:${String(bl.resonance).padStart(2)}  ` +
                 `sens:${sens}  ${temperament.slice(0, 30)}...`);
         }
         console.log();
@@ -521,7 +521,7 @@ async function cmdSetup(opts) {
         env.PSYCHE_LOCALE = locale;
     let actions = 0;
     // ── 1. MCP clients ────────────────────────────────────
-    const mcpEntry = { command: "npx", args: ["-y", "psyche-mcp"], env };
+    const mcpEntry = { command: "npx", args: ["-y", "psyche-ai", "mcp"], env };
     const { execFileSync } = await import("node:child_process");
     // Claude Code — use `claude mcp add` for hot-reload (no restart needed)
     let claudeCodeDone = false;
@@ -537,12 +537,12 @@ async function cmdSetup(opts) {
             actions++;
         }
         else {
-            const addArgs = ["mcp", "add", "psyche", "-e", "PSYCHE_LOCALE=" + (locale || "zh")];
+            const addArgs = ["mcp", "add", "-s", "user", "psyche", "-e", "PSYCHE_LOCALE=" + (locale || "zh")];
             if (name)
                 addArgs.push("-e", "PSYCHE_NAME=" + name);
             if (mbti)
                 addArgs.push("-e", "PSYCHE_MBTI=" + mbti.toUpperCase());
-            addArgs.push("--", "npx", "-y", "psyche-mcp");
+            addArgs.push("--", "npx", "-y", "psyche-ai", "mcp");
             execFileSync("claude", addArgs, { encoding: "utf-8", timeout: 10000 });
             console.log("  ✓ Claude Code — configured (live, no restart needed)");
             claudeCodeDone = true;
@@ -651,6 +651,7 @@ Usage:
   psyche intensity              Show info about personality intensity config
   psyche reset <dir> [--full]
   psyche diagnose <dir> [--github]   Run health checks & show diagnostic report
+  psyche mcp [--mbti TYPE] [--name NAME]   Start MCP server (stdio)
   psyche setup [--proxy -t URL] [-n NAME] [--mbti TYPE]  Auto-configure MCP + proxy
   psyche upgrade [--check]           Check/apply package updates safely
   psyche probe [--json]              Verify the runtime is truly callable
@@ -684,11 +685,12 @@ Examples:
   psyche profiles
   psyche profiles --mbti ENFP
 
-  # Auto-configure all MCP clients
-  psyche setup --mbti ENFP --name Luna
+  # Auto-configure all MCP clients (one command, done)
+  psyche setup
+  psyche setup --name Luna
 
   # Universal proxy — works with any agent using OpenAI SDK
-  psyche setup --proxy -t https://api.openai.com/v1 --mbti ENFP
+  psyche setup --proxy -t https://api.openai.com/v1
 
   # Check for new package versions without applying them
   psyche upgrade --check
@@ -846,6 +848,11 @@ async function main() {
                 await cmdProbe(values.json ?? false);
                 break;
             }
+            case "mcp": {
+                // Delegate to the MCP adapter — same process, no npx indirection.
+                await import("./adapters/mcp.js");
+                return; // mcp.ts owns the process from here
+            }
             case "setup": {
                 const { values } = parseArgs({
                     args: rest,

package/dist/context-classifier.js

@@ -25,8 +25,8 @@ export function extractContextFeatures(state, userId) {
     const relKey = userId ?? "_default";
     const relationship = state.relationships[relKey] ?? state.relationships["_default"];
     const relationshipPhase = relationship?.phase ?? "stranger";
-    // Recent stimuli from emotional history (last 3)
-    const recentStimuli = state.emotionalHistory
+    // Recent stimuli from state history (last 3)
+    const recentStimuli = state.stateHistory
         .slice(-3)
         .map((snap) => snap.stimulus)
         .filter((s) => s !== null);

package/dist/core.d.ts

@@ -8,7 +8,7 @@ export interface PsycheEngineConfig {
     locale?: Locale;
     stripUpdateTags?: boolean;
     emotionalContagionRate?: number;
-    maxChemicalDelta?: number;
+    maxDimensionDelta?: number;
     /** @deprecated Compact mode is always on since v10. This option is ignored. */
     compactMode?: boolean;
     /** Operating mode: "natural" (default), "work" (minimal emotions), "companion" (full emotions) */
@@ -77,7 +77,7 @@ export interface ProcessInputResult {
 export interface ProcessOutputResult {
     /** LLM output with <psyche_update> tags stripped */
     cleanedText: string;
-    /** Whether chemistry was meaningfully updated (contagion or psyche_update) */
+    /** Whether self-state was meaningfully updated (contagion or psyche_update) */
     stateChanged: boolean;
 }
 export interface ProcessOutputOptions {
@@ -150,7 +150,7 @@ export declare class PsycheEngine {
      */
     getProtocol(locale?: Locale): string;
     /**
-     * End the current session: compress emotionalHistory into a rich summary
+     * End the current session: compress stateHistory into a rich summary
      * stored in relationship.memory[], then preserve only core/recent context.
      * Auto-generates diagnostic report and persists to log.
      *