openfeelz 0.9.5 → 0.9.7

package/README.md

@@ -26,7 +26,7 @@ Most agents vibes-check each message independently and forget everything between
 - **LLM Classification** -- Automatically classify user/agent emotions via OpenAI-compatible models
 - **Web Dashboard** -- Glassmorphism UI at `/emotion-dashboard`
 - **MCP Server** -- Expose emotional state to Cursor, Claude Desktop, etc.
-- **CLI Tools** -- `openclaw emotion status`, `reset`, `personality`, `history`, `decay`
+- **CLI Tools** -- `openclaw emotion status`, `reset`, `personality`, `history`, `decay`, **`wizard`** (interactive configuration)
 
 ## Installation
 
@@ -37,7 +37,15 @@ openclaw plugins install openfeelz
 openclaw plugins enable openfeelz
 ```
 
-Restart the gateway after installing. To pin a version: `openclaw plugins install openfeelz@0.9.4`. To install from a local clone (e.g. for development), run `npm run build` in the repo first, then `openclaw plugins install /path/to/openfeelz`.
+Restart the gateway after installing. To pin a version: `openclaw plugins install openfeelz@0.9.4`. To install from a local clone (e.g. for development), run `npm run build` in the repo first, then `openclaw plugins install /path/to/openfeelz`. To refresh an already-installed plugin from this repo without reinstalling: `./scripts/sync-to-openclaw.sh` (syncs `dist/` and manifest files into `~/.openclaw/extensions/openfeelz`; override with a path or `OPENCLAW_EXTENSIONS_DIR`). The interactive config command is **`openclaw emotion wizard`** (not `configure`, to avoid clashing with OpenClaw’s top-level `openclaw configure`).
+
+**If `wizard` doesn’t appear under `openclaw emotion`:** OpenClaw has a top-level `configure` command, so this plugin uses `wizard` for its interactive config. If the subcommand is still missing, OpenClaw may be loading an older copy: add to your OpenClaw config (e.g. `~/.openclaw/openclaw.json`):
+
+```json
+"plugins": { "load": { "paths": ["/absolute/path/to/openfeelz"] } }
+```
+
+Run `npm run build` in the repo; no sync or reinstall needed. Confirm with `openclaw emotion -V` (should show 0.9.6+); then run `openclaw emotion wizard`. If you use a custom state dir (`OPENCLAW_STATE_DIR`), sync to that extensions dir: `./scripts/sync-to-openclaw.sh "$OPENCLAW_STATE_DIR/extensions/openfeelz"`.
 
 When using **reasoning models** (e.g. gpt-5-mini, o1, o3), the classifier omits custom temperature so the API accepts the request. Optional classification logging can be enabled via config (see `docs/OPENFEELZ-FIX-COMPLETE.md`).
 
@@ -250,8 +258,37 @@ openclaw emotion reset               # Reset all to baseline
 openclaw emotion reset --dimensions pleasure,arousal
 openclaw emotion history --limit 20  # Recent stimuli
 openclaw emotion decay --dimension pleasure --rate 0.05
+openclaw emotion wizard             # Interactive configuration wizard (see below)
 ```
 
+### Configuration wizard: `openclaw emotion wizard`
+
+The **configuration wizard** is the CLI option for guided setup. It runs an interactive (TUI-style) flow where you can:
+
+- **a) Choose a preset** — Pick one of 10 famous-personality presets (OCEAN profiles based on biographical research). Each option is listed with a short explanation. The wizard applies that preset’s personality to your agent’s state.
+- **b) Customize** — Skip presets and go straight to custom settings, or after picking a preset you can optionally configure model, decay half-life, rumination, context injection, and dashboard.
+
+So: run **`openclaw emotion wizard`** to open the wizard; it will ask whether you want a **preset** (with explanations) or **custom**, then optionally walk through key config fields with validation and help text.
+
+#### Default personalities in the picker
+
+The preset picker offers these 10 options (diverse across time, region, and domain; OCEAN values from biographical/psychological literature, see `docs/personality-presets-research.md`):
+
+| Preset | Description |
+|--------|-------------|
+| **Nelson Mandela** | Anti-apartheid leader, President of South Africa (20th c.) — high agreeableness & extraversion, emotional stability. |
+| **Wangari Maathai** | Environmentalist and Nobel Peace laureate (Kenya, 20th c.) — Green Belt Movement; visionary, resilient. |
+| **Frida Kahlo** | Painter (Mexico, 20th c.) — high openness and emotional intensity. |
+| **Confucius** | Philosopher and teacher (Ancient China) — high conscientiousness & agreeableness, emphasis on li and ren. |
+| **Simón Bolívar** | Liberator and revolutionary (South America, 19th c.) — visionary, charismatic; driven, mood swings. |
+| **Sitting Bull** | Lakota leader and resistance figure (Indigenous Americas, 19th c.) — steadfast, defiant sovereignty, calm under pressure. |
+| **Albert Einstein** | Theoretical physicist (Germany/US, 20th c.) — high openness & conscientiousness, introspective. |
+| **Marie Curie** | Physicist and chemist (Poland/France, 19th–20th c.) — perseverance, solitary focus. |
+| **Sejong the Great** | King and scholar, creator of Hangul (Korea, 15th c.) — scholarly, benevolent, humble. |
+| **Rabindranath Tagore** | Poet and philosopher, Nobel laureate (India, 20th c.) — very high openness and agreeableness. |
+
+Choosing a preset updates the agent’s OCEAN personality (and thus baselines and decay rates). You can still edit config manually or via the OpenClaw web UI.
+
 ## Dashboard
 
 `http://localhost:<gateway-port>/emotion-dashboard`

package/dist/index.js

@@ -262,7 +262,13 @@ const emotionEnginePlugin = {
             });
         }
         // -- CLI --
-        api.registerCli(({ program }) => registerEmotionCli({ program, getManager, config }), { commands: ["emotion"] });
+        api.registerCli((ctx) => registerEmotionCli({
+            program: ctx.program,
+            getManager,
+            config,
+            workspaceDir: ctx.workspaceDir,
+            openclawConfig: ctx.config,
+        }), { commands: ["emotion"] });
         // -- HTTP Dashboard --
         if (config.dashboardEnabled) {
             api.registerHttpRoute({

package/dist/src/cli/cli.d.ts

@@ -10,6 +10,7 @@
  *   openclaw emotion reset [--dimensions <names>]
  *   openclaw emotion history [--limit <n>]
  *   openclaw emotion decay --dimension <name> --rate <n>
+ *   openclaw emotion wizard   Interactive wizard (presets or custom)
  */
 import type { Command } from "commander";
 import type { EmotionEngineConfig } from "../types.js";
@@ -18,6 +19,8 @@ interface CliParams {
     program: Command;
     getManager: (agentId: string) => StateManager;
     config?: Partial<EmotionEngineConfig>;
+    workspaceDir?: string;
+    openclawConfig?: unknown;
 }
-export declare function registerEmotionCli({ program, getManager, config }: CliParams): void;
+export declare function registerEmotionCli({ program, getManager, config, workspaceDir, openclawConfig, }: CliParams): void;
 export {};

package/dist/src/cli/cli.js

@@ -10,18 +10,42 @@
  *   openclaw emotion reset [--dimensions <names>]
  *   openclaw emotion history [--limit <n>]
  *   openclaw emotion decay --dimension <name> --rate <n>
+ *   openclaw emotion wizard   Interactive wizard (presets or custom)
  */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const OPENFEELZ_VERSION = require("../../package.json").version ?? "0.0.0";
 import { DEFAULT_CONFIG } from "../types.js";
 import { DIMENSION_NAMES, OCEAN_TRAITS } from "../types.js";
 import { computePrimaryEmotion, computeOverallIntensity, } from "../model/emotion-model.js";
 import { formatEmotionBlock } from "../format/prompt-formatter.js";
-export function registerEmotionCli({ program, getManager, config }) {
+import { runConfigureWizard } from "./configure-wizard.js";
+export function registerEmotionCli({ program, getManager, config, workspaceDir, openclawConfig, }) {
     const root = program
         .command("emotion")
-        .description("OpenFeelz utilities")
-        .option("--agent <id>", "Agent ID", "main");
+        .description("OpenFeelz utilities (personality, emotion state, configure wizard)")
+        .version(OPENFEELZ_VERSION, "-V, --version", "output OpenFeelz version")
+        .option("--agent <id>", "Agent ID", "main")
+        .addHelpText("beforeAll", `OpenFeelz v${OPENFEELZ_VERSION}\n`);
     const agentOpts = () => root.opts().agent ?? "main";
     // -----------------------------------------------------------------------
+    // wizard (list first so it appears at top of help; avoid "configure" - conflicts with openclaw configure)
+    // -----------------------------------------------------------------------
+    root
+        .command("wizard")
+        .description("Interactive configuration wizard (presets or custom)")
+        .option("--agent <id>", "Agent ID", "main")
+        .action(async (opts) => {
+        const agentId = opts.agent ?? agentOpts();
+        await runConfigureWizard({
+            getManager,
+            agentId,
+            pluginConfig: config,
+            openclawConfig,
+            workspaceDir,
+        });
+    });
+    // -----------------------------------------------------------------------
     // status
     // -----------------------------------------------------------------------
     root

package/dist/src/cli/configure-validation.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Validation helpers for the configure wizard.
+ * Bounds aligned with openclaw.plugin.json configSchema.
+ */
+import type { OCEANProfile } from "../types.js";
+export type ConfigNumberKey = "confidenceMin" | "halfLifeHours" | "trendWindowHours" | "maxHistory" | "ruminationThreshold" | "ruminationMaxStages" | "decayServiceIntervalMinutes";
+export declare function getConfigNumberBounds(key: ConfigNumberKey | string): {
+    min?: number;
+    max?: number;
+} | undefined;
+/**
+ * Validate a numeric config value. Returns error message or undefined if valid.
+ */
+export declare function validateConfigNumber(key: ConfigNumberKey | string, value: number): string | undefined;
+/**
+ * Validate OCEAN profile (each trait 0-1). Returns error message or undefined if valid.
+ */
+export declare function validateOceanProfile(profile: OCEANProfile): string | undefined;

package/dist/src/cli/configure-validation.js

@@ -0,0 +1,51 @@
+/**
+ * Validation helpers for the configure wizard.
+ * Bounds aligned with openclaw.plugin.json configSchema.
+ */
+import { OCEAN_TRAITS } from "../types.js";
+const BOUNDS = {
+    confidenceMin: { min: 0, max: 1 },
+    halfLifeHours: { min: 0.1 },
+    trendWindowHours: { min: 1 },
+    maxHistory: { min: 10 },
+    ruminationThreshold: { min: 0, max: 1 },
+    ruminationMaxStages: { min: 1, max: 10 },
+    decayServiceIntervalMinutes: { min: 1 },
+};
+export function getConfigNumberBounds(key) {
+    return BOUNDS[key];
+}
+/**
+ * Validate a numeric config value. Returns error message or undefined if valid.
+ */
+export function validateConfigNumber(key, value) {
+    const bounds = getConfigNumberBounds(key);
+    if (!bounds) {
+        return `Unknown config key: ${key}`;
+    }
+    if (typeof value !== "number" || Number.isNaN(value)) {
+        return `Value must be a number`;
+    }
+    if (bounds.min !== undefined && value < bounds.min) {
+        return `Must be at least ${bounds.min}`;
+    }
+    if (bounds.max !== undefined && value > bounds.max) {
+        return `Must be at most ${bounds.max}`;
+    }
+    return undefined;
+}
+/**
+ * Validate OCEAN profile (each trait 0-1). Returns error message or undefined if valid.
+ */
+export function validateOceanProfile(profile) {
+    for (const trait of OCEAN_TRAITS) {
+        const v = profile[trait];
+        if (typeof v !== "number" || Number.isNaN(v)) {
+            return `${trait} must be a number`;
+        }
+        if (v < 0 || v > 1) {
+            return `${trait} must be between 0 and 1 (got ${v})`;
+        }
+    }
+    return undefined;
+}

package/dist/src/cli/configure-wizard.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Interactive configuration wizard for OpenFeelz.
+ * Uses @clack/prompts; run via `openclaw emotion wizard`.
+ */
+import type { StateManager } from "../state/state-manager.js";
+import type { EmotionEngineConfig } from "../types.js";
+export interface ConfigureWizardContext {
+    getManager: (agentId: string) => StateManager;
+    agentId: string;
+    pluginConfig?: Partial<EmotionEngineConfig>;
+    openclawConfig?: unknown;
+    workspaceDir?: string;
+}
+/**
+ * Run the interactive configure wizard.
+ * Persists personality/state via StateManager; plugin config via openclaw config set or instructions.
+ */
+export declare function runConfigureWizard(ctx: ConfigureWizardContext): Promise<void>;

package/dist/src/cli/configure-wizard.js

@@ -0,0 +1,144 @@
+/**
+ * Interactive configuration wizard for OpenFeelz.
+ * Uses @clack/prompts; run via `openclaw emotion wizard`.
+ */
+import { spawn } from "node:child_process";
+import { DEFAULT_CONFIG } from "../types.js";
+import { validateConfigNumber } from "./configure-validation.js";
+function runOpenClawConfigSet(path, value) {
+    return new Promise((resolve) => {
+        const valStr = typeof value === "string" ? value : JSON.stringify(value);
+        const child = spawn("openclaw", ["config", "set", `plugins.entries.openfeelz.config.${path}`, valStr], {
+            stdio: "inherit",
+            shell: true,
+        });
+        child.on("close", (code) => resolve(code === 0));
+        child.on("error", () => resolve(false));
+    });
+}
+/**
+ * Run the interactive configure wizard.
+ * Persists personality/state via StateManager; plugin config via openclaw config set or instructions.
+ */
+export async function runConfigureWizard(ctx) {
+    const clack = await import("@clack/prompts");
+    const { intro, outro, select, confirm, text, isCancel } = clack;
+    intro("Configure OpenFeelz (model, decay, personality)");
+    const current = ctx.pluginConfig ?? {};
+    let configChanged = false;
+    try {
+        const choice = await select({
+            message: "Start from a famous-personality preset or configure manually?",
+            options: [
+                { value: "preset", label: "Choose a famous-personality preset" },
+                { value: "custom", label: "Custom (no preset)" },
+            ],
+        });
+        if (isCancel(choice)) {
+            outro("Cancelled.");
+            return;
+        }
+        if (choice === "preset") {
+            const { listPresets, getPreset, applyPresetToState } = await import("../config/personality-presets.js");
+            const presets = listPresets();
+            const presetChoice = await select({
+                message: "Select a personality preset",
+                options: presets.map((p) => ({ value: p.id, label: `${p.name} — ${p.shortDescription}` })),
+            });
+            if (isCancel(presetChoice)) {
+                outro("Cancelled.");
+                return;
+            }
+            if (presetChoice && typeof presetChoice === "string") {
+                const preset = getPreset(presetChoice);
+                if (preset) {
+                    const manager = ctx.getManager(ctx.agentId);
+                    let state = await manager.getState();
+                    state = applyPresetToState(state, preset.id);
+                    await manager.saveState(state);
+                    console.log(`Applied preset: ${preset.name}`);
+                }
+            }
+        }
+        const configureMore = await confirm({
+            message: "Configure model, decay, and feature flags?",
+            initialValue: true,
+        });
+        if (isCancel(configureMore)) {
+            outro("Done.");
+            return;
+        }
+        if (configureMore) {
+            const modelVal = await text({
+                message: "Classification model",
+                placeholder: current.model ?? DEFAULT_CONFIG.model,
+                defaultValue: current.model ?? DEFAULT_CONFIG.model,
+            });
+            if (!isCancel(modelVal) && modelVal.trim()) {
+                const ok = await runOpenClawConfigSet("model", modelVal.trim());
+                if (ok)
+                    configChanged = true;
+                else
+                    console.log("Tip: run openclaw config set plugins.entries.openfeelz.config.model \"<model>\" to save.");
+            }
+            const halfLifeStr = await text({
+                message: "Decay half-life (hours)",
+                placeholder: String(current.halfLifeHours ?? DEFAULT_CONFIG.halfLifeHours),
+                defaultValue: String(current.halfLifeHours ?? DEFAULT_CONFIG.halfLifeHours),
+            });
+            if (!isCancel(halfLifeStr)) {
+                const num = parseFloat(halfLifeStr);
+                const err = validateConfigNumber("halfLifeHours", num);
+                if (err) {
+                    console.log(`Validation: ${err}`);
+                }
+                else {
+                    const ok = await runOpenClawConfigSet("halfLifeHours", num);
+                    if (ok)
+                        configChanged = true;
+                }
+            }
+            const ruminationEnabledVal = await confirm({
+                message: "Enable rumination? (intense emotions influence state over multiple turns)",
+                initialValue: current.ruminationEnabled ?? DEFAULT_CONFIG.ruminationEnabled,
+            });
+            if (!isCancel(ruminationEnabledVal)) {
+                const ok = await runOpenClawConfigSet("ruminationEnabled", ruminationEnabledVal);
+                if (ok)
+                    configChanged = true;
+            }
+            const contextEnabledVal = await confirm({
+                message: "Prepend emotional context to the agent system prompt?",
+                initialValue: current.contextEnabled ?? DEFAULT_CONFIG.contextEnabled,
+            });
+            if (!isCancel(contextEnabledVal)) {
+                const ok = await runOpenClawConfigSet("contextEnabled", contextEnabledVal);
+                if (ok)
+                    configChanged = true;
+            }
+            const dashboardEnabledVal = await confirm({
+                message: "Serve emotion dashboard at /emotion-dashboard?",
+                initialValue: current.dashboardEnabled ?? DEFAULT_CONFIG.dashboardEnabled,
+            });
+            if (!isCancel(dashboardEnabledVal)) {
+                const ok = await runOpenClawConfigSet("dashboardEnabled", dashboardEnabledVal);
+                if (ok)
+                    configChanged = true;
+            }
+        }
+        if (configChanged) {
+            outro("Done. Restart the gateway to apply plugin config changes.");
+        }
+        else {
+            outro("Done.");
+        }
+    }
+    catch (err) {
+        if (err && typeof err === "object" && "message" in err && String(err.message).includes("cancel")) {
+            outro("Cancelled.");
+        }
+        else {
+            throw err;
+        }
+    }
+}

package/dist/src/config/personality-presets.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pre-defined OCEAN personality presets based on internationally known
+ * historical figures. Diverse across time, region, and domain.
+ * Research: Perplexity API (see docs/personality-presets-research.md).
+ */
+import type { EmotionEngineState, OCEANProfile } from "../types.js";
+export interface PersonalityPreset {
+    id: string;
+    name: string;
+    shortDescription: string;
+    ocean: OCEANProfile;
+    rationale: string;
+}
+export declare function listPresets(): readonly PersonalityPreset[];
+export declare function getPreset(id: string): PersonalityPreset | undefined;
+export declare function isPresetValid(preset: PersonalityPreset): boolean;
+/**
+ * Apply a preset's OCEAN profile to state. Recomputes baseline and decay rates.
+ * @throws if preset id is unknown
+ */
+export declare function applyPresetToState(state: EmotionEngineState, presetId: string): EmotionEngineState;

package/dist/src/config/personality-presets.js

@@ -0,0 +1,131 @@
+/**
+ * Pre-defined OCEAN personality presets based on internationally known
+ * historical figures. Diverse across time, region, and domain.
+ * Research: Perplexity API (see docs/personality-presets-research.md).
+ */
+import { computeBaseline, computeDimensionDecayRates, computeEmotionDecayRates, } from "../model/personality.js";
+function clampOcean(value) {
+    return Math.max(0, Math.min(1, value));
+}
+function clampProfile(profile) {
+    return {
+        openness: clampOcean(profile.openness),
+        conscientiousness: clampOcean(profile.conscientiousness),
+        extraversion: clampOcean(profile.extraversion),
+        agreeableness: clampOcean(profile.agreeableness),
+        neuroticism: clampOcean(profile.neuroticism),
+    };
+}
+const PRESETS = [
+    {
+        id: "einstein",
+        name: "Albert Einstein",
+        shortDescription: "Theoretical physicist (Germany/US, 20th c.)",
+        ocean: { openness: 0.95, conscientiousness: 0.9, extraversion: 0.4, agreeableness: 0.5, neuroticism: 0.3 },
+        rationale: "Biographical analyses: extreme curiosity, persistence, introspective; low extraversion.",
+    },
+    {
+        id: "marie-curie",
+        name: "Marie Curie",
+        shortDescription: "Physicist and chemist (Poland/France, 19th–20th c.)",
+        ocean: { openness: 0.9, conscientiousness: 0.95, extraversion: 0.3, agreeableness: 0.6, neuroticism: 0.5 },
+        rationale: "Perseverance, solitary focus; biographical synthesis (Nobel, PMC).",
+    },
+    {
+        id: "mandela",
+        name: "Nelson Mandela",
+        shortDescription: "Anti-apartheid leader, President of South Africa (20th c.)",
+        ocean: { openness: 0.9, conscientiousness: 0.9, extraversion: 0.85, agreeableness: 0.9, neuroticism: 0.1 },
+        rationale: "Leadership analyses: forgiveness, charisma, consensus-building, emotional stability.",
+    },
+    {
+        id: "wangari-maathai",
+        name: "Wangari Maathai",
+        shortDescription: "Environmentalist and Nobel Peace laureate (Kenya, 20th c.)",
+        ocean: { openness: 0.9, conscientiousness: 0.9, extraversion: 0.7, agreeableness: 0.4, neuroticism: 0.3 },
+        rationale: "Green Belt Movement founder; visionary, relentless, confrontational; resilient (Unbowed, USF, Washington History).",
+    },
+    {
+        id: "frida-kahlo",
+        name: "Frida Kahlo",
+        shortDescription: "Painter (Mexico, 20th c.)",
+        ocean: { openness: 0.9, conscientiousness: 0.58, extraversion: 0.5, agreeableness: 0.75, neuroticism: 0.8 },
+        rationale: "Art and writings: high openness and neuroticism, moderate others (sarahransomeart, truity).",
+    },
+    {
+        id: "confucius",
+        name: "Confucius",
+        shortDescription: "Philosopher and teacher (Ancient China)",
+        ocean: { openness: 0.6, conscientiousness: 0.9, extraversion: 0.4, agreeableness: 0.9, neuroticism: 0.2 },
+        rationale: "Teachings (li, ren); cerebralquotient, Simply Psychology.",
+    },
+    {
+        id: "simon-bolivar",
+        name: "Simón Bolívar",
+        shortDescription: "Liberator and revolutionary (South America, 19th c.)",
+        ocean: { openness: 0.9, conscientiousness: 0.85, extraversion: 0.8, agreeableness: 0.4, neuroticism: 0.7 },
+        rationale: "Enlightenment reader, visionary; iron will, charismatic; prideful, mood swings (Britannica, EBSCO).",
+    },
+    {
+        id: "sitting-bull",
+        name: "Sitting Bull",
+        shortDescription: "Lakota leader and resistance figure (Indigenous Americas, 19th c.)",
+        ocean: { openness: 0.4, conscientiousness: 0.9, extraversion: 0.6, agreeableness: 0.2, neuroticism: 0.3 },
+        rationale: "Traditional, steadfast; tenacious leadership; defiant sovereignty, calm under pressure (NPS, Course Hero).",
+    },
+    {
+        id: "sejong",
+        name: "Sejong the Great",
+        shortDescription: "King and scholar, creator of Hangul (Korea, 15th c.)",
+        ocean: { openness: 0.9, conscientiousness: 0.95, extraversion: 0.4, agreeableness: 0.9, neuroticism: 0.2 },
+        rationale: "Scholarly dedication, Hangul for literacy; humble, benevolent; Confucian virtues (Asia Society, Weebly).",
+    },
+    {
+        id: "tagore",
+        name: "Rabindranath Tagore",
+        shortDescription: "Poet and philosopher, Nobel laureate (India, 20th c.)",
+        ocean: { openness: 0.9, conscientiousness: 0.65, extraversion: 0.6, agreeableness: 0.85, neuroticism: 0.35 },
+        rationale: "Biographical: very high openness/agreeableness (tagoreanworld, wikipedia).",
+    },
+];
+export function listPresets() {
+    return PRESETS;
+}
+export function getPreset(id) {
+    return PRESETS.find((p) => p.id === id);
+}
+export function isPresetValid(preset) {
+    if (!preset.id || !preset.name || !preset.shortDescription || !preset.ocean || !preset.rationale) {
+        return false;
+    }
+    const { ocean } = preset;
+    const traits = ["openness", "conscientiousness", "extraversion", "agreeableness", "neuroticism"];
+    for (const t of traits) {
+        const v = ocean[t];
+        if (typeof v !== "number" || v < 0 || v > 1)
+            return false;
+    }
+    return true;
+}
+/**
+ * Apply a preset's OCEAN profile to state. Recomputes baseline and decay rates.
+ * @throws if preset id is unknown
+ */
+export function applyPresetToState(state, presetId) {
+    const preset = getPreset(presetId);
+    if (!preset) {
+        throw new Error(`Unknown personality preset: ${presetId}`);
+    }
+    const personality = clampProfile(preset.ocean);
+    const baseline = computeBaseline(personality);
+    const decayRates = computeDimensionDecayRates(personality);
+    const emotionDecayRates = computeEmotionDecayRates(personality);
+    return {
+        ...state,
+        personality,
+        baseline,
+        decayRates,
+        emotionDecayRates,
+        meta: { ...state.meta, totalUpdates: state.meta.totalUpdates + 1 },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openfeelz",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "description": "PAD + Ekman + OCEAN emotional model plugin for OpenClaw agents",
   "type": "module",
   "main": "dist/index.js",