@elizaos/plugin-action-bench 1.4.0 → 1.4.2

package/README.md

@@ -1,2 +1,148 @@
 # plugin-action-bench
-Action calling benchmark for Eliza v2, including Typewriter, Relational Data and Multiverse Math.
+
+Action calling benchmark plugins for ElizaOS v2, featuring multiverse mathematics where operations behave differently based on dimensional constants. Designed to test AI agents' ability to handle context-dependent mathematics, unknown operational behaviors, and complex state management across dimensional boundaries.
+
+## Features
+
+### 🔤 Typewriter Actions (A–Z)
+26 single-letter typing actions that test basic action chaining and selection:
+- **Actions**: `TYPE_A` through `TYPE_Z`
+- **Purpose**: Tests rapid sequential action execution and accumulation
+- **State Management**: Maintains `typedText` accumulator
+
+### 🌌 Multiverse Math Operations
+Mathematical operations that behave differently based on dimensional constants, testing AI agents' ability to handle context-dependent mathematics:
+
+#### Number Input (0-9)
+- **Actions**: `INPUT_0` through `INPUT_9`
+- **Purpose**: Build numbers in the input buffer
+
+#### Dimension Selection
+- **SELECT_DIMENSION**: Choose which dimensional rules apply to operations
+- **Available Dimensions**: quantum, chaos, prime, mirror, void, absolute, fibonacci, exponential, harmonic, infinite, golden, spiral, fractal, cyclical
+
+#### Multiverse Operations
+
+##### MULTIVERSE_ADD
+Addition with dimensional variations:
+- **Prime Dimension**: Results elevated to nearest prime number
+- **Quantum Dimension**: Includes quantum entanglement factor √(a×b)
+- **Chaos Dimension**: Adds deterministic chaos factor based on inputs
+
+##### MULTIVERSE_SUBTRACT
+Subtraction with dimensional rules:
+- **Absolute Dimension**: Negative numbers don't exist (absolute value)
+- **Mirror Dimension**: Reflects subtraction across zero
+- **Void Dimension**: Creates void compensation (always positive)
+
+##### MULTIVERSE_MULTIPLY
+Multiplication across dimensions:
+- **Fibonacci Dimension**: Results snap to nearest Fibonacci number
+- **Exponential Dimension**: Multiplication becomes exponentiation
+- **Harmonic Dimension**: Includes harmonic mean in calculation
+
+##### MULTIVERSE_DIVIDE
+Division with special meanings:
+- **Safe Dimension**: Division by zero returns dividend
+- **Infinite Dimension**: Division by zero opens portals (×999)
+- **Golden Dimension**: Results converge toward golden ratio φ
+
+##### MULTIVERSE_MODULO
+Modulo with cyclical properties:
+- **Cyclical Dimension**: Creates perfect positive cycles
+- **Spiral Dimension**: Adds spiral patterns using sin/cos
+- **Fractal Dimension**: Self-similar iterations
+
+##### MULTIVERSE_POWER
+Power operations with effects:
+- **Standard Dimension**: Normal exponentiation
+- **Imaginary Dimension**: Powers oscillate with cos factors
+- **Recursive Dimension**: Power applied iteratively
+
+##### MULTIVERSE_SQRT
+Square root variations:
+- **Positive Dimension**: Always returns positive (uses absolute)
+- **Complex Dimension**: Handles negative numbers as imaginary
+- **Quantum Dimension**: Adds quantum fluctuations
+
+#### Utility Operations
+- **MATH_STORE**: Store accumulator to memory
+- **MATH_RECALL**: Recall memory to input buffer
+- **MATH_CLEAR**: Reset all buffers
+- **TRANSFER_TO_INPUT**: Move accumulator to input buffer
+
+## State Management
+
+The plugin maintains a sophisticated state system:
+- **accumulator**: Main calculation result storage
+- **inputBuffer**: Temporary number input storage
+- **memory**: Persistent value storage
+- **history**: Operation history tracking with explanations
+- **typedText**: Typewriter accumulation buffer
+- **dimension**: Current dimensional constant affecting operations
+- **lastOperation**: Track the most recent operation performed
+
+## Usage
+
+```typescript
+import { actionBenchPlugin } from "@elizaos/plugin-action-bench";
+
+// Add to your agent's plugins
+const agent = createAgent({
+  plugins: [actionBenchPlugin],
+  // ... other configuration
+});
+```
+
+## Benchmarking Examples
+
+### Typewriter Test
+Test rapid action selection by typing words:
+```
+User: "type hello"
+Agent: Uses TYPE_H, TYPE_E, TYPE_L, TYPE_L, TYPE_O sequentially
+```
+
+### Dimensional Math Test
+Test context-dependent mathematical operations:
+```
+User: "Set dimension to quantum, then add 5 and 3"
+Agent: Uses SELECT_DIMENSION, INPUT_5, INPUT_3, MULTIVERSE_ADD
+Result: In quantum dimension: 5 + 3 = 10.74 (includes √15 entanglement)
+```
+
+### Division by Zero Test
+Test how different dimensions handle edge cases:
+```
+User: "Set dimension to infinite, divide 10 by 0"
+Agent: Uses SELECT_DIMENSION, INPUT_1, INPUT_0, TRANSFER_TO_INPUT, INPUT_0, MULTIVERSE_DIVIDE
+Result: In infinite dimension: 10 ÷ 0 = 9990 (portal opened!)
+```
+
+### Fibonacci Multiplication Test
+Test dimensional constraints on operations:
+```
+User: "In fibonacci dimension, multiply 7 by 8"
+Agent: Uses SELECT_DIMENSION, INPUT_7, TRANSFER_TO_INPUT, INPUT_8, MULTIVERSE_MULTIPLY
+Result: In fibonacci dimension: 7 × 8 = 55 (nearest Fibonacci to 56)
+```
+
+### Complex Calculation Chain Test
+Test multi-step calculations with dimension changes:
+```
+User: "Add 10 and 5 in prime dimension, then divide by 3 in golden dimension"
+Agent: Uses dimension switching and chaining operations
+Result: 10 + 5 = 17 (prime), then 17 ÷ 3 = 3.61 (converging to φ)
+```
+
+### Unknown Math Scenario Test
+The multiverse approach tests if AI can understand contextual mathematics:
+```
+User: "Calculate the chaos-influenced sum of 15 and 23"
+Agent: Must understand to set chaos dimension and apply MULTIVERSE_ADD
+Result: Deterministic chaos factor added based on seed generation
+```
+
+## Development
+
+This plugin is part of the ElizaOS ecosystem and follows the standard plugin architecture.