v1.03 Remove compaction hook

Author: joostvanwollingen

AGENTS.md

@@ -47,7 +47,6 @@ src/
 | Hook | Purpose |
 |------|---------|
 | `experimental.chat.system.transform` | Inject personality into system prompt |
-| `experimental.session.compacting` | Preserve personality during compaction |
 | `event` | Drift mood after assistant responses |
 | `command.execute.before` | Handle `/mood` and `/personality` commands |
 

README.md

@@ -1,6 +1,8 @@
 # OpenCode Personality Plugin
 
-A configurable personality and mood system plugin for [OpenCode](https://opencode.ai). Give your AI assistant a distinct personality with customizable moods that drift over time.
+**Stop talking to a machine. Give your AI a soul.**
+
+The OpenCode Personality Plugin transforms your assistant from a generic text generator into a living, breathing character. With a sophisticated mood state machine and deep configuration options, your AI doesn't just follow instructions—it responds with attitude, emotion, and a personality that evolves over time.
 
 > **Note:** This project is not built by the OpenCode team and is not affiliated with OpenCode in any way.
 
@@ -28,16 +30,14 @@ A configurable personality and mood system plugin for [OpenCode](https://opencod
 
 ## Features
 
-- **Custom Personality**: Define your assistant's name, description, emoji usage, and slang intensity
-- **Dynamic Moods**: Configure custom moods with scores that drift naturally during conversations
-- **Multiple personalities**: Global and project-level configs with intelligent merging allow you to have a personality for all of your projects and to override per project.
-- **Toast Notifications**: Get notified when the mood shifts
-- **Commands**: Interactive commands to manage personality and mood
-- **Session Compaction**: Personality context preserved during session compaction
+- **Custom Personality**: Define name, description, emoji usage, and slang intensity.
+- **Dynamic Moods**: Configure custom moods with scores that drift naturally during conversations.
+- **Intelligent Merging**: Global and project-level configs allow for project-specific overrides.
+- **Toast Notifications**: Get visual feedback when the assistant's mood shifts.
+- **Interactive Commands**: Manage your assistant's persona directly from the chat.
 
-## Installation
 
-### From npm
+## Installation
 
 Add to your `~/.config/opencode/opencode.json`:
 
@@ -57,26 +57,16 @@ Add to your `~/.config/opencode/opencode.json`:
 }
 ```
 
-> **Note:** The `command` definitions are required because OpenCode's plugin API doesn't yet support programmatic command registration. Commands must be defined in your config file.
-
-### From Source
-
-Clone the repository and add to `opencode.json`:
-
-```json
-{
-  "plugin": ["./path/to/opencode-personality/src/index.ts"]
-}
-```
+> **Note:** Commands must be defined in your config file as OpenCode's plugin API doesn't yet support programmatic registration.
 
 ## Quick Start
 
 1. Run `opencode`
-2. Use `/personality create` to have the assistant guide you through creating a configuration interactively.
+2. Use `/personality create` to have the assistant guide you through setup.
 
 ### Manual Setup
 
-1. Create a personality config file at `~/.config/opencode/personality.json` (global) or `.opencode/personality.json` (project):
+Create a config at `~/.config/opencode/personality.json` (global) or `.opencode/personality.json` (project):
 
 ```json
 {
@@ -92,10 +82,6 @@ Clone the repository and add to `opencode.json`:
 }
 ```
 
-2. Start OpenCode - the personality will be automatically applied!
-
-3. Use `/mood` to check or change the current mood.
-
 ## Configuration Reference
 
 ### PersonalityFile
@@ -105,7 +91,7 @@ Clone the repository and add to `opencode.json`:
 | `name` | string | `""` | Name the assistant uses when asked |
 | `description` | string | `""` | Personality description injected into prompts |
 | `emoji` | boolean | `false` | Whether to use emojis in responses |
-| `slangIntensity` | number | `0` | Slang usage intensity (0-1). 0=none, 0.3=light, 0.7=heavy |
+| `slangIntensity` | number | `0` | Slang usage intensity (0-1) |
 | `moods` | MoodDefinition[] | (defaults) | Custom mood definitions |
 | `mood` | MoodConfig | (see below) | Mood system configuration |
 
@@ -129,8 +115,6 @@ Clone the repository and add to `opencode.json`:
 
 ### Default Moods
 
-If `moods` is not specified, these defaults are used:
-
 | Name | Hint | Score |
 |------|------|-------|
 | `bored` | Responses feel slightly disinterested | -2 |
@@ -143,46 +127,34 @@ If `moods` is not specified, these defaults are used:
 
 ### `/mood [mood|status]`
 
-Check or set the current mood.
+Check or set the current mood permanently.
 
-```
-/mood           # Show current mood status
-/mood status    # Same as above
+```bash
+/mood status    # Show current mood status
 /mood happy     # Set mood to "happy" permanently
 ```
 
-**Note:** The `/mood` command sets moods permanently. For temporary overrides (message or session duration), use the `setMood` tool.
-
 ### `/personality <subcommand>`
 
 Manage personality configuration.
 
 | Subcommand | Description |
 |------------|-------------|
 | `show` | Display the merged configuration |
-| `create` | Start an interactive conversation to create a new config |
-| `edit` | Start an interactive conversation to modify the config |
-| `edit --field <name> --value <value>` | Directly update a specific field |
-| `reset --confirm` | Delete the personality config file |
+| `create` | Interactive setup (use `--scope global` for global) |
+| `edit` | Interactive edit or direct update with `--field` and `--value` |
+| `reset` | Delete the config file (requires `--confirm`) |
 
 **Examples:**
-
-```
-/personality show                                    # Show merged config
-/personality create                                  # Create config (project scope)
-/personality create --scope global                   # Create config (global scope)
-/personality edit                                    # Edit config interactively
-/personality edit --field name --value "Assistant"  # Update single field
-/personality edit --field emoji --value true        # Enable emojis
-/personality reset --scope project --confirm        # Delete project config
+```bash
+/personality show
+/personality create --scope global
+/personality edit --field emoji --value true
+/personality reset --scope project --confirm
 ```
 
-**Editable fields:** `name`, `description`, `emoji`, `slangIntensity`, `mood.enabled`, `mood.default`, `mood.drift`
-
 ## Tools
 
-The plugin exposes tools that the LLM can use during conversations.
-
 ### `setMood`
 
 Override the current mood with optional duration.
@@ -192,32 +164,8 @@ Override the current mood with optional duration.
 | `mood` | string | Yes | Name of the mood to set |
 | `duration` | string | No | `"message"`, `"session"` (default), or `"permanent"` |
 
-**Duration options:**
-- `message`: Override lasts for the next response only
-- `session`: Override lasts until OpenCode restarts (default)
-- `permanent`: Override persists across sessions
-
-### `savePersonality`
-
-Save a personality configuration. Used by the assistant when you run `/personality create` or `/personality edit`.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `description` | string | Yes | Personality description |
-| `name` | string | No | Name for the assistant |
-| `emoji` | boolean | No | Enable emoji usage |
-| `slangIntensity` | number | No | Slang level (0-1) |
-| `moodEnabled` | boolean | No | Enable mood system |
-| `moodDefault` | string | No | Default mood name |
-| `moodDrift` | number | No | Drift amount (0-1) |
-| `moodToast` | boolean | No | Show toast on mood change (default: true) |
-| `moods` | array | No | Custom mood definitions |
-| `scope` | string | No | `"project"` (default) or `"global"` |
-
 ## Custom Moods Example
 
-Create moods tailored to your assistant's personality:
-
 ```json
 {
   "name": "Surfer Dude",
@@ -238,37 +186,7 @@ Create moods tailored to your assistant's personality:
 }
 ```
 
-**Tip:** Checkout the `examples`-folder for a few prebuilt personalities.
-
-## Config Precedence
-
-1. **Project config** (`.opencode/personality.json`) takes precedence
-2. **Global config** (`~/.config/opencode/personality.json`) is used as fallback
-3. When both exist, they are **deep merged** with project values overriding global
-
-## How It Works
-
-1. **System Prompt Injection**: The plugin injects personality traits into the system prompt via the `experimental.chat.system.transform` hook
-2. **Mood Drift**: After each assistant response, the mood score drifts randomly within the configured `drift` amount
-3. **Mood Resolution**: The current score maps to the nearest defined mood by score value
-4. **Toast Notifications**: When the mood changes, a toast notification appears
-5. **Session Compaction**: During session compaction, the personality context is preserved
-
-## Development
-
-```bash
-# Install dependencies
-npm install
-
-# Type check
-npm run typecheck
-
-# Lint
-npm run lint
-
-# Build
-npm run build
-```
+**Tip:** Checkout the `examples` folder for more prebuilt personalities.
 
 ## License
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-personality",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Configurable personality and mood system plugin for OpenCode",
   "type": "module",
   "main": "dist/index.js",

src/index.ts

@@ -80,13 +80,6 @@ const personalityPlugin: Plugin = async (input: PluginInput) => {
       output.system.push(`<personality>\n${prompt}\n</personality>`)
     },
 
-    "experimental.session.compacting": async (_hookInput, output) => {
-      const state = loadMoodState(statePath, config)
-      output.context.push(
-        `Assistant personality: ${config.description}. Current mood: ${state.current}.`
-      )
-    },
-
     event: async ({ event }) => {
       if (event.type === "message.updated" && config.mood.enabled) {
         const msg = event.properties as { info?: { sessionID?: string; role?: string } }

src/tools/savePersonality.ts

@@ -61,19 +61,19 @@ export function createSavePersonalityTool(
       const scope = args.scope ?? "project"
       const scopePath = resolveScopePath(scope, configResult)
 
-      const config: Partial<PersonalityFile> = {
-        name: args.name?.trim() ?? "",
-        description: args.description.trim(),
-        emoji: args.emoji ?? false,
-        slangIntensity: args.slangIntensity ?? 0,
-        mood: {
-          enabled: args.moodEnabled ?? false,
-          default: args.moodDefault ?? "happy",
-          override: null,
-          drift: args.moodDrift ?? 0.2,
-          toast: args.moodToast ?? true,
-        },
-      }
+       const config: Partial<PersonalityFile> = {
+         name: args.name?.trim() ?? "",
+         description: args.description.trim(),
+         emoji: args.emoji ?? false,
+         slangIntensity: args.slangIntensity ?? 0,
+         mood: {
+           enabled: args.moodEnabled ?? false,
+           default: args.moodDefault ?? "happy",
+           override: null,
+           drift: args.moodDrift ?? 0.2,
+           toast: args.moodToast ?? true,
+         },
+       }
 
       if (args.moods && args.moods.length > 0) {
         config.moods = args.moods as MoodDefinition[]