@elizaos/plugin-commands 2.0.0-alpha.9 → 2.0.0-beta.1

package/auto-enable.ts

@@ -0,0 +1,24 @@
+// Auto-enable check for @elizaos/plugin-commands.
+//
+// Plugin manifest entry-point — referenced by package.json's
+// `elizaos.plugin.autoEnableModule`. Keep this module light: env reads only,
+// no service init, no transitive imports of the full plugin runtime. The
+// auto-enable engine loads dozens of these per boot.
+import type { PluginAutoEnableContext } from "@elizaos/core";
+
+function isFeatureEnabled(
+	config: PluginAutoEnableContext["config"],
+	key: string,
+): boolean {
+	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;
+	}
+	return false;
+}
+
+/** Enable when `config.features.commands` is truthy / not explicitly disabled. */
+export function shouldEnable(ctx: PluginAutoEnableContext): boolean {
+	return isFeatureEnabled(ctx.config, "commands");
+}

package/dist/cjs/index.cjs

@@ -65,7 +65,7 @@ __export(exports_src, {
   commandRegistryProvider: () => commandRegistryProvider
 });
 module.exports = __toCommonJS(exports_src);
-var import_core3 = require("@elizaos/core");
+var import_core = require("@elizaos/core");
 
 // src/registry.ts
 var DEFAULT_COMMANDS = [
@@ -577,407 +577,16 @@ function extractCommand(text) {
   return { command, remainingText: command.rawArgs };
 }
 
-// src/actions/commands-list.ts
-var commandsListAction = {
-  name: "COMMANDS_LIST",
-  description: "List all available commands with their aliases. Only activates for /commands or /cmds slash commands.",
-  similes: ["/commands", "/cmds"],
-  validate: async (runtime, message) => {
-    const textRaw = message.content?.text ?? "";
-    const text = textRaw.toLowerCase();
-    const hasKeyword = text.includes("/commands") || text.includes("/cmds") || text.includes("commands");
-    const hasRegex = /^(?:\/|!)\s*(?:commands|cmds)\b/i.test(textRaw);
-    const hasContext = Boolean(runtime?.agentId || message?.roomId || message?.content);
-    const hasInput = textRaw.trim().length > 0;
-    if (!(hasKeyword && hasRegex && hasContext && hasInput)) {
-      return false;
-    }
-    const detection = detectCommand(textRaw);
-    return detection.isCommand && detection.command?.key === "commands";
-  },
-  async handler(_runtime, _message, _state, _options, callback) {
-    const commands = getEnabledCommands();
-    const lines = [`**Commands (${commands.length}):**
-`];
-    for (const cmd of commands) {
-      const aliases = cmd.textAliases.join(", ");
-      const authNote = cmd.requiresAuth ? " [auth]" : "";
-      const elevatedNote = cmd.requiresElevated ? " [elevated]" : "";
-      lines.push(`• **${cmd.key}**: ${aliases}${authNote}${elevatedNote}`);
-    }
-    const replyText = lines.join(`
-`);
-    await callback?.({ text: replyText });
-    return {
-      success: true,
-      text: replyText,
-      data: { commandCount: commands.length }
-    };
-  },
-  examples: [
-    [
-      { name: "user", content: { text: "/commands" } },
-      {
-        name: "assistant",
-        content: {
-          text: `**Commands (15):**
-
-• **help**: /help, /h, /?
-• **status**: /status, /s...`
-        }
-      }
-    ]
-  ]
-};
-
-// src/actions/help.ts
-function formatCommandList(commands) {
-  const lines = [`**Available Commands:**
-`];
-  const categories = [
-    { key: "status", name: "Status" },
-    { key: "session", name: "Session" },
-    { key: "options", name: "Options" },
-    { key: "management", name: "Management" },
-    { key: "media", name: "Media" },
-    { key: "tools", name: "Tools" }
-  ];
-  for (const cat of categories) {
-    const catCommands = commands.filter((c) => c.category === cat.key);
-    if (catCommands.length === 0)
-      continue;
-    lines.push(`
-**${cat.name}:**`);
-    for (const cmd of catCommands) {
-      const aliases = cmd.textAliases.slice(0, 2).join(", ");
-      lines.push(`• ${aliases} - ${cmd.description}`);
-    }
-  }
-  const uncategorized = commands.filter((c) => !c.category);
-  if (uncategorized.length > 0) {
-    lines.push(`
-**Other:**`);
-    for (const cmd of uncategorized) {
-      const aliases = cmd.textAliases.slice(0, 2).join(", ");
-      lines.push(`• ${aliases} - ${cmd.description}`);
-    }
-  }
-  return lines.join(`
-`);
-}
-var helpAction = {
-  name: "HELP_COMMAND",
-  description: "Show available commands and their descriptions. Only activates for /help, /h, or /? slash commands.",
-  similes: ["/help", "/h", "/?"],
-  validate: async (runtime, message) => {
-    const textRaw = message.content?.text ?? "";
-    const text = textRaw.toLowerCase();
-    const hasKeyword = text.includes("/help") || text.includes("/h") || text.includes("/?");
-    const hasRegex = /^(?:\/|!)\s*(?:help|h|\?)(?:\s|$|:)/i.test(textRaw);
-    const hasContext = Boolean(runtime?.agentId || message?.roomId || message?.content);
-    const hasInput = textRaw.trim().length > 0;
-    if (!(hasKeyword && hasRegex && hasContext && hasInput)) {
-      return false;
-    }
-    const detection = detectCommand(textRaw);
-    return detection.isCommand && detection.command?.key === "help";
-  },
-  async handler(_runtime, message, _state, _options, callback) {
-    const detection = detectCommand(message?.content?.text ?? "");
-    if (!detection.isCommand || detection.command?.key !== "help") {
-      return { success: false, text: "" };
-    }
-    const commands = getEnabledCommands();
-    const helpText = formatCommandList(commands);
-    await callback?.({ text: helpText });
-    return {
-      success: true,
-      text: helpText,
-      data: { commandCount: commands.length }
-    };
-  },
-  examples: [
-    [
-      { name: "user", content: { text: "/help" } },
-      {
-        name: "assistant",
-        content: {
-          text: `**Available Commands:**
-
-**Status:**
-• /help - Show available commands...`
-        }
-      }
-    ],
-    [
-      { name: "user", content: { text: "/?" } },
-      {
-        name: "assistant",
-        content: {
-          text: `**Available Commands:**
-
-**Status:**
-• /help - Show available commands...`
-        }
-      }
-    ]
-  ]
-};
-
-// src/actions/models.ts
-var import_core = require("@elizaos/core");
-function describeModelType(modelType) {
-  const descriptions = {
-    [import_core.ModelType.TEXT_SMALL]: "Text (Small)",
-    [import_core.ModelType.TEXT_LARGE]: "Text (Large)",
-    [import_core.ModelType.TEXT_REASONING_SMALL]: "Reasoning (Small)",
-    [import_core.ModelType.TEXT_REASONING_LARGE]: "Reasoning (Large)",
-    [import_core.ModelType.TEXT_COMPLETION]: "Text Completion",
-    [import_core.ModelType.TEXT_EMBEDDING]: "Embedding",
-    [import_core.ModelType.IMAGE]: "Image Generation",
-    [import_core.ModelType.IMAGE_DESCRIPTION]: "Image Description",
-    [import_core.ModelType.TRANSCRIPTION]: "Transcription",
-    [import_core.ModelType.TEXT_TO_SPEECH]: "Text-to-Speech",
-    [import_core.ModelType.AUDIO]: "Audio",
-    [import_core.ModelType.VIDEO]: "Video",
-    [import_core.ModelType.OBJECT_SMALL]: "Object (Small)",
-    [import_core.ModelType.OBJECT_LARGE]: "Object (Large)",
-    [import_core.ModelType.RESEARCH]: "Research"
-  };
-  return descriptions[modelType] ?? modelType;
-}
-var modelsAction = {
-  name: "MODELS_COMMAND",
-  description: "List available AI models and providers. Only activates for /models slash command.",
-  similes: ["/models"],
-  validate: async (runtime, message) => {
-    const textRaw = message.content?.text ?? "";
-    const text = textRaw.toLowerCase();
-    const hasKeyword = text.includes("/models") || text.includes("models");
-    const hasRegex = /^(?:\/|!)\s*models\b/i.test(textRaw);
-    const hasContext = Boolean(runtime?.agentId || message?.roomId || message?.content);
-    const hasInput = textRaw.trim().length > 0;
-    if (!(hasKeyword && hasRegex && hasContext && hasInput)) {
-      return false;
-    }
-    const detection = detectCommand(textRaw);
-    return detection.isCommand && detection.command?.key === "models";
-  },
-  async handler(runtime, _message, _state, _options, callback) {
-    const lines = [`**Available Models:**
-`];
-    try {
-      const registeredTypes = [];
-      const seen = new Set;
-      for (const modelType of Object.values(import_core.ModelType)) {
-        if (seen.has(modelType))
-          continue;
-        seen.add(modelType);
-        try {
-          const handler = runtime.getModel(modelType);
-          if (handler) {
-            registeredTypes.push(modelType);
-          }
-        } catch {}
-      }
-      if (registeredTypes.length > 0) {
-        lines.push("**Registered Model Types:**");
-        for (const modelType of registeredTypes) {
-          lines.push(`• ${describeModelType(modelType)} (\`${modelType}\`)`);
-        }
-      } else {
-        lines.push("No model handlers are currently registered.");
-      }
-      const modelProvider = runtime.getSetting("MODEL_PROVIDER");
-      const modelName = runtime.getSetting("MODEL_NAME");
-      if (modelProvider || modelName) {
-        lines.push(`
-**Current Configuration:**`);
-        if (modelProvider)
-          lines.push(`• Provider: ${modelProvider}`);
-        if (modelName)
-          lines.push(`• Model: ${modelName}`);
-      }
-    } catch (err) {
-      import_core.logger.warn({ src: "plugin-commands", err }, "Error querying runtime models");
-      lines.push("Unable to query available models.");
-    }
-    lines.push(`
-
-_Use /model <provider/model> to switch models._`);
-    const replyText = lines.join(`
-`);
-    await callback?.({ text: replyText });
-    return {
-      success: true,
-      text: replyText
-    };
-  },
-  examples: [
-    [
-      { name: "user", content: { text: "/models" } },
-      {
-        name: "assistant",
-        content: {
-          text: "**Available Models:**\n\n**Registered Model Types:**\n• Text (Large) (`text_large`)\n• Text (Small) (`text_small`)..."
-        }
-      }
-    ]
-  ]
-};
-
-// src/actions/status.ts
-async function buildStatusReport(runtime, roomId) {
-  const lines = [`**Session Status:**
-`];
-  lines.push(`**Agent:** ${runtime.character.name ?? runtime.agentId}`);
-  lines.push(`**Room:** ${roomId}`);
-  try {
-    const directiveService = runtime.getService("directive-parser");
-    if (directiveService) {
-      const state = directiveService.getSessionState?.(roomId);
-      if (state) {
-        lines.push(`
-**Directives:**`);
-        lines.push(`• Thinking: ${state.thinking}`);
-        lines.push(`• Verbose: ${state.verbose}`);
-        lines.push(`• Reasoning: ${state.reasoning}`);
-        lines.push(`• Elevated: ${state.elevated}`);
-        if (state.model?.provider || state.model?.model) {
-          const modelStr = state.model.provider ? `${state.model.provider}/${state.model.model}` : state.model.model;
-          lines.push(`• Model: ${modelStr}`);
-        }
-      }
-    }
-  } catch {}
-  try {
-    const tasks = await runtime.getTasks({
-      roomId,
-      agentIds: [runtime.agentId]
-    });
-    if (tasks.length > 0) {
-      lines.push(`
-**Tasks:** ${tasks.length} pending`);
-    }
-  } catch {}
-  return lines.join(`
-`);
-}
-var statusAction = {
-  name: "STATUS_COMMAND",
-  description: "Show session directive settings via /status slash command. Only activates for /status or /s prefix.",
-  similes: ["/status", "/s"],
-  validate: async (runtime, message) => {
-    const textRaw = message.content?.text ?? "";
-    const text = textRaw.toLowerCase();
-    const hasKeyword = text.includes("/status") || text.includes("/s") || text.includes("status");
-    const hasRegex = /^(?:\/|!)\s*(?:status|s)\b/i.test(textRaw);
-    const hasContext = Boolean(runtime?.agentId || message?.roomId || message?.content);
-    const hasInput = textRaw.trim().length > 0;
-    if (!(hasKeyword && hasRegex && hasContext && hasInput)) {
-      return false;
-    }
-    const detection = detectCommand(textRaw);
-    return detection.isCommand && detection.command?.key === "status";
-  },
-  async handler(runtime, message, _state, _options, callback) {
-    const statusText = await buildStatusReport(runtime, message.roomId);
-    await callback?.({ text: statusText });
-    return {
-      success: true,
-      text: statusText
-    };
-  },
-  examples: [
-    [
-      { name: "user", content: { text: "/status" } },
-      {
-        name: "assistant",
-        content: {
-          text: `**Session Status:**
-
-**Agent:** Eliza
-**Room:** room-456
-
-**Directives:**
-• Thinking: low...`
-        }
-      }
-    ]
-  ]
-};
-
-// src/actions/stop.ts
-var import_core2 = require("@elizaos/core");
-var stopAction = {
-  name: "STOP_COMMAND",
-  description: "Stop current operation or abort running tasks. Triggered by /stop, /abort, or /cancel slash commands only.",
-  similes: ["/stop", "/abort", "/cancel"],
-  validate: async (runtime, message) => {
-    const textRaw = message.content?.text ?? "";
-    const text = textRaw.toLowerCase();
-    const hasKeyword = text.includes("/stop") || text.includes("/abort") || text.includes("/cancel") || text.includes("stop");
-    const hasRegex = /^(?:\/|!)\s*(?:stop|abort|cancel)\b/i.test(textRaw);
-    const hasContext = Boolean(runtime?.agentId || message?.roomId || message?.content);
-    const hasInput = textRaw.trim().length > 0;
-    if (!(hasKeyword && hasRegex && hasContext && hasInput)) {
-      return false;
-    }
-    const detection = detectCommand(textRaw);
-    return detection.isCommand && ["stop", "abort", "cancel"].includes(detection.command?.key ?? "");
-  },
-  async handler(runtime, message, _state, _options, callback) {
-    try {
-      await runtime.emitEvent(import_core2.EventType.HOOK_COMMAND_STOP, {
-        runtime,
-        sessionKey: message.roomId,
-        messages: [],
-        timestamp: new Date,
-        context: {
-          entityId: message.entityId,
-          source: message.content?.source
-        },
-        command: "stop",
-        senderId: message.entityId,
-        commandSource: message.content?.source
-      });
-    } catch (err) {
-      import_core2.logger.warn({ src: "plugin-commands", err }, "Failed to emit HOOK_COMMAND_STOP event");
-    }
-    const replyText = "✓ Stop requested. Current operations will be cancelled.";
-    await callback?.({ text: replyText });
-    return {
-      success: true,
-      text: replyText
-    };
-  },
-  examples: [
-    [
-      { name: "user", content: { text: "/stop" } },
-      {
-        name: "assistant",
-        content: {
-          text: "✓ Stop requested. Current operations will be cancelled."
-        }
-      }
-    ],
-    [
-      { name: "user", content: { text: "/abort" } },
-      {
-        name: "assistant",
-        content: {
-          text: "✓ Stop requested. Current operations will be cancelled."
-        }
-      }
-    ]
-  ]
-};
-
 // src/index.ts
 var commandRegistryProvider = {
   name: "COMMAND_REGISTRY",
   description: "Available chat commands and their descriptions",
+  descriptionCompressed: "Available chat commands and descriptions.",
   dynamic: true,
+  contexts: ["general", "automation"],
+  contextGate: { anyOf: ["general", "automation"] },
+  cacheStable: true,
+  cacheScope: "agent",
   async get(runtime, message, _state) {
     useRuntime(runtime.agentId);
     const text = message.content?.text ?? "";
@@ -1034,13 +643,12 @@ var commandsPlugin = {
   name: "commands",
   description: "Chat command system with /help, /status, /reset, etc.",
   providers: [commandRegistryProvider],
-  actions: [
-    helpAction,
-    statusAction,
-    stopAction,
-    modelsAction,
-    commandsListAction
-  ],
+  autoEnable: {
+    shouldEnable: (_env, config) => {
+      const f = config?.features?.commands;
+      return f === true || typeof f === "object" && f !== null && f.enabled !== false;
+    }
+  },
   config: {
     COMMANDS_ENABLED: "true",
     COMMANDS_CONFIG_ENABLED: "false",
@@ -1064,7 +672,7 @@ var commandsPlugin = {
             if (hasCommand("hello world")) {
               throw new Error("Should not detect plain text as command");
             }
-            import_core3.logger.success("Command prefix detection works correctly");
+            import_core.logger.success("Command prefix detection works correctly");
           }
         },
         {
@@ -1080,7 +688,7 @@ var commandsPlugin = {
             if (detection.command?.args[0] !== "high") {
               throw new Error(`Expected arg 'high', got '${detection.command?.args[0]}'`);
             }
-            import_core3.logger.success("Command argument parsing works correctly");
+            import_core.logger.success("Command argument parsing works correctly");
           }
         },
         {
@@ -1094,7 +702,7 @@ var commandsPlugin = {
             if (normalized2 !== "/help") {
               throw new Error(`Expected '/help', got '${normalized2}'`);
             }
-            import_core3.logger.success("Command normalization works correctly");
+            import_core.logger.success("Command normalization works correctly");
           }
         },
         {
@@ -1107,7 +715,7 @@ var commandsPlugin = {
             if (cmd.key !== "help") {
               throw new Error(`Expected key 'help', got '${cmd.key}'`);
             }
-            import_core3.logger.success("Command alias lookup works correctly");
+            import_core.logger.success("Command alias lookup works correctly");
           }
         },
         {
@@ -1120,7 +728,7 @@ var commandsPlugin = {
             if (cmd.key !== "status") {
               throw new Error(`Expected key 'status', got '${cmd.key}'`);
             }
-            import_core3.logger.success("Command key lookup works correctly");
+            import_core.logger.success("Command key lookup works correctly");
           }
         }
       ]
@@ -1140,7 +748,7 @@ var commandsPlugin = {
             if (!cmdHelp || !cmdStatus) {
               throw new Error("Should have help and status commands");
             }
-            import_core3.logger.success("Command registry works correctly");
+            import_core.logger.success("Command registry works correctly");
           }
         },
         {
@@ -1162,7 +770,7 @@ var commandsPlugin = {
             if (notFound) {
               throw new Error("Should not find unregistered command");
             }
-            import_core3.logger.success("Custom command registration works correctly");
+            import_core.logger.success("Custom command registration works correctly");
           }
         },
         {
@@ -1176,14 +784,14 @@ var commandsPlugin = {
             if (!allStatus) {
               throw new Error("All returned commands should be in status category");
             }
-            import_core3.logger.success("Command categorization works correctly");
+            import_core.logger.success("Command categorization works correctly");
           }
         }
       ]
     }
   ],
   async init(config, runtime) {
-    import_core3.logger.log("[plugin-commands] Initializing command system");
+    import_core.logger.log("[plugin-commands] Initializing command system");
     initForRuntime(runtime.agentId);
     const configEnabled = config.COMMANDS_CONFIG_ENABLED === "true";
     const debugEnabled = config.COMMANDS_DEBUG_ENABLED === "true";
@@ -1206,9 +814,9 @@ var commandsPlugin = {
       restartCmd.enabled = restartEnabled;
     }
     const enabledCount = getEnabledCommands().length;
-    import_core3.logger.log(`[plugin-commands] ${enabledCount} commands enabled for agent ${runtime.agentId}`);
+    import_core.logger.log(`[plugin-commands] ${enabledCount} commands enabled for agent ${runtime.agentId}`);
   }
 };
 var src_default = commandsPlugin;
 
-//# debugId=29584248BB32069264756E2164756E21
+//# debugId=00FC26667A6E870A64756E2164756E21