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

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/index.ts
 import {
-  logger as logger3
+  logger
 } from "@elizaos/core";
 
 // src/registry.ts
@@ -513,400 +513,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 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
-import { logger, ModelType } from "@elizaos/core";
-function describeModelType(modelType) {
-  const descriptions = {
-    [ModelType.TEXT_SMALL]: "Text (Small)",
-    [ModelType.TEXT_LARGE]: "Text (Large)",
-    [ModelType.TEXT_REASONING_SMALL]: "Reasoning (Small)",
-    [ModelType.TEXT_REASONING_LARGE]: "Reasoning (Large)",
-    [ModelType.TEXT_COMPLETION]: "Text Completion",
-    [ModelType.TEXT_EMBEDDING]: "Embedding",
-    [ModelType.IMAGE]: "Image Generation",
-    [ModelType.IMAGE_DESCRIPTION]: "Image Description",
-    [ModelType.TRANSCRIPTION]: "Transcription",
-    [ModelType.TEXT_TO_SPEECH]: "Text-to-Speech",
-    [ModelType.AUDIO]: "Audio",
-    [ModelType.VIDEO]: "Video",
-    [ModelType.OBJECT_SMALL]: "Object (Small)",
-    [ModelType.OBJECT_LARGE]: "Object (Large)",
-    [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(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) {
-      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 });
-    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
-import { EventType, logger as logger2 } from "@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(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) {
-      logger2.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 ?? "";
@@ -963,13 +579,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",
@@ -993,7 +608,7 @@ var commandsPlugin = {
             if (hasCommand("hello world")) {
               throw new Error("Should not detect plain text as command");
             }
-            logger3.success("Command prefix detection works correctly");
+            logger.success("Command prefix detection works correctly");
           }
         },
         {
@@ -1009,7 +624,7 @@ var commandsPlugin = {
             if (detection.command?.args[0] !== "high") {
               throw new Error(`Expected arg 'high', got '${detection.command?.args[0]}'`);
             }
-            logger3.success("Command argument parsing works correctly");
+            logger.success("Command argument parsing works correctly");
           }
         },
         {
@@ -1023,7 +638,7 @@ var commandsPlugin = {
             if (normalized2 !== "/help") {
               throw new Error(`Expected '/help', got '${normalized2}'`);
             }
-            logger3.success("Command normalization works correctly");
+            logger.success("Command normalization works correctly");
           }
         },
         {
@@ -1036,7 +651,7 @@ var commandsPlugin = {
             if (cmd.key !== "help") {
               throw new Error(`Expected key 'help', got '${cmd.key}'`);
             }
-            logger3.success("Command alias lookup works correctly");
+            logger.success("Command alias lookup works correctly");
           }
         },
         {
@@ -1049,7 +664,7 @@ var commandsPlugin = {
             if (cmd.key !== "status") {
               throw new Error(`Expected key 'status', got '${cmd.key}'`);
             }
-            logger3.success("Command key lookup works correctly");
+            logger.success("Command key lookup works correctly");
           }
         }
       ]
@@ -1069,7 +684,7 @@ var commandsPlugin = {
             if (!cmdHelp || !cmdStatus) {
               throw new Error("Should have help and status commands");
             }
-            logger3.success("Command registry works correctly");
+            logger.success("Command registry works correctly");
           }
         },
         {
@@ -1091,7 +706,7 @@ var commandsPlugin = {
             if (notFound) {
               throw new Error("Should not find unregistered command");
             }
-            logger3.success("Custom command registration works correctly");
+            logger.success("Custom command registration works correctly");
           }
         },
         {
@@ -1105,14 +720,14 @@ var commandsPlugin = {
             if (!allStatus) {
               throw new Error("All returned commands should be in status category");
             }
-            logger3.success("Command categorization works correctly");
+            logger.success("Command categorization works correctly");
           }
         }
       ]
     }
   ],
   async init(config, runtime) {
-    logger3.log("[plugin-commands] Initializing command system");
+    logger.log("[plugin-commands] Initializing command system");
     initForRuntime(runtime.agentId);
     const configEnabled = config.COMMANDS_CONFIG_ENABLED === "true";
     const debugEnabled = config.COMMANDS_DEBUG_ENABLED === "true";
@@ -1135,7 +750,7 @@ var commandsPlugin = {
       restartCmd.enabled = restartEnabled;
     }
     const enabledCount = getEnabledCommands().length;
-    logger3.log(`[plugin-commands] ${enabledCount} commands enabled for agent ${runtime.agentId}`);
+    logger.log(`[plugin-commands] ${enabledCount} commands enabled for agent ${runtime.agentId}`);
   }
 };
 var src_default = commandsPlugin;
@@ -1166,4 +781,4 @@ export {
   commandRegistryProvider
 };
 
-//# debugId=B67A62E4C9BE0E2864756E2164756E21
+//# debugId=BAB16333EBF522DA64756E2164756E21