@elizaos/plugin-commands 2.0.0-beta.1 → 2.0.11-beta.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,83 @@
+# @elizaos/plugin-commands
+
+Chat command system for [elizaOS](https://github.com/elizaos/eliza) agents. Adds a `/help`-style slash-command surface with a shared registry, parser, and LLM context provider.
+
+## What it does
+
+- Provides a typed command registry that other plugins and the agent runtime use to register slash commands.
+- Detects `/` and `!`-prefixed messages and parses them into structured `ParsedCommand` objects.
+- Injects a `COMMAND_REGISTRY` provider into the LLM context — full command documentation only when the message is a command, an empty hint otherwise (keeps normal-message prompts clean).
+- Ships 25 built-in command *definitions* grouped by category. The actual Action handlers live in the agent or other plugins.
+
+## Built-in commands
+
+| Category | Commands |
+|---|---|
+| Status | `/help` (`/h`, `/?`), `/commands` (`/cmds`), `/status` (`/s`), `/context` (`/ctx`), `/whoami` (`/who`) |
+| Session | `/stop` (`/abort`, `/cancel`), `/restart`\*, `/reset`\*, `/new`, `/compact` |
+| Options | `/think` (`/thinking`, `/t`), `/verbose` (`/v`), `/reasoning` (`/reason`), `/elevated`\* (`/elev`), `/model` (`/m`), `/models`, `/usage`, `/queue` (`/q`) |
+| Management | `/allowlist`\* (`/allow`), `/approve`\*, `/subagents`\* (`/sub`), `/config`\*† (`/cfg`), `/debug`\*† |
+| Media | `/tts` (`/voice`) |
+| Tools | `/bash`\*‡ (`/sh`, `/!`) |
+
+\* Requires auth (`requiresAuth: true`).
+† Disabled by default.
+‡ Requires elevated permissions AND is disabled by default.
+
+## Installation
+
+```bash
+bun add @elizaos/plugin-commands
+```
+
+The plugin is **opt-in**. It auto-enables when `config.features.commands` is truthy in your agent configuration.
+
+## Configuration
+
+Add to your agent's character/config file:
+
+```json
+{
+  "features": {
+    "commands": true
+  }
+}
+```
+
+### Environment variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `COMMANDS_CONFIG_ENABLED` | `false` | Enable `/config` command |
+| `COMMANDS_DEBUG_ENABLED` | `false` | Enable `/debug` command |
+| `COMMANDS_BASH_ENABLED` | `false` | Enable `/bash` shell execution (elevated) |
+| `COMMANDS_RESTART_ENABLED` | `true` | Enable `/restart` command |
+
+## Registering a custom command
+
+```ts
+import { registerCommand } from "@elizaos/plugin-commands";
+
+registerCommand({
+  key: "ping",
+  description: "Ping the agent",
+  textAliases: ["/ping"],
+  scope: "both",
+  category: "status",
+  acceptsArgs: false,
+});
+```
+
+You still need an `Action` in your plugin to handle the command. Use `hasCommand()` and `detectCommand()` from `@elizaos/plugin-commands` in your action's `validate()` to match the right key.
+
+## Parser API
+
+```ts
+import { hasCommand, detectCommand, normalizeCommandBody } from "@elizaos/plugin-commands";
+
+hasCommand("/help");                   // true
+hasCommand("hello world");            // false
+detectCommand("/think:high");          // { isCommand: true, command: { key: "think", args: ["high"], ... } }
+normalizeCommandBody("@bot /status", "bot"); // "/status"
+```
+

package/auto-enable.ts

@@ -10,7 +10,7 @@ function isFeatureEnabled(
 	config: PluginAutoEnableContext["config"],
 	key: string,
 ): boolean {
-	const f = (config?.features as Record<string, unknown> | undefined)?.[key];
+	const f = (config.features as Record<string, unknown> | undefined)?.[key];
 	if (f === true) return true;
 	if (f && typeof f === "object" && f !== null) {
 		return (f as Record<string, unknown>).enabled !== false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-commands",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.11-beta.7",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -15,8 +15,24 @@
     "./package.json": "./package.json",
     ".": {
       "types": "./dist/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
   "files": [
@@ -32,7 +48,7 @@
     }
   },
   "dependencies": {
-    "@elizaos/core": "2.0.0-beta.1"
+    "@elizaos/core": "2.0.11-beta.7"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.14",
@@ -42,15 +58,15 @@
     "vitest": "^4.0.18"
   },
   "scripts": {
-    "build": "bun run build.ts",
+    "build": "bun run build.ts && tsc --emitDeclarationOnly",
     "dev": "bun --hot build.ts",
     "test": "vitest run",
     "clean": "rm -rf dist .turbo .turbo-tsconfig.json tsconfig.tsbuildinfo",
-    "format": "../../node_modules/.bin/biome format --write .",
-    "format:check": "../../node_modules/.bin/biome format .",
-    "lint": "../../node_modules/.bin/biome check --write --unsafe .",
-    "lint:check": "../../node_modules/.bin/biome check .",
-    "typecheck": "tsc --noEmit"
+    "format": "bunx @biomejs/biome format --write .",
+    "format:check": "bunx @biomejs/biome format .",
+    "lint": "bunx @biomejs/biome check --write --unsafe .",
+    "lint:check": "bunx @biomejs/biome check .",
+    "typecheck": "tsgo --noEmit"
   },
   "publishConfig": {
     "access": "public"
@@ -58,13 +74,6 @@
   "agentConfig": {
     "pluginType": "elizaos:plugin:1.0.0",
     "pluginParameters": {
-      "COMMANDS_ENABLED": {
-        "type": "boolean",
-        "description": "Enable command system",
-        "required": false,
-        "default": "true",
-        "sensitive": false
-      },
       "COMMANDS_CONFIG_ENABLED": {
         "type": "boolean",
         "description": "Enable /config command",
@@ -103,5 +112,6 @@
     "platformDetails": {
       "node": "Default export (Node.js)"
     }
-  }
+  },
+  "gitHead": "cdbc876f793d96073d7eb0d09715a031ce0cd32e"
 }