wind-agent-cli 1.37.2

package/server/modules/commands/commands.routes.ts

@@ -0,0 +1,655 @@
+// @ts-nocheck -- temporary while command handlers are extracted into the injected service.
+import path from "path";
+
+import express from "express";
+
+import { parseFrontMatter } from "../../shared/frontmatter.js";
+
+type CommandsRouterDependencies = {
+  fileSystem: typeof import('node:fs/promises');
+  homeDirectory(): string;
+  appRoot: string;
+  models: typeof import('../providers/index.js').providerModelsService;
+  runtime: {
+    uptime(): number;
+    memoryUsage(): NodeJS.MemoryUsage;
+    version: string;
+    platform: NodeJS.Platform;
+    pid: number;
+  };
+};
+
+/** Creates Commands routes around explicit filesystem, model-catalog, and runtime adapters. */
+export function createCommandsRouter(dependencies: CommandsRouterDependencies): express.Router {
+const fs = dependencies.fileSystem;
+const os = { homedir: dependencies.homeDirectory };
+const APP_ROOT = dependencies.appRoot;
+const providerModelsService = dependencies.models;
+const process = dependencies.runtime;
+const router = express.Router();
+
+const MODEL_PROVIDERS = ["claude", "cursor", "codex", "opencode"];
+
+const MODEL_PROVIDER_LABELS = {
+  claude: "Claude",
+  cursor: "Cursor",
+  codex: "Codex",
+  opencode: "OpenCode",
+};
+
+const readModelProvider = (value) => {
+  if (typeof value !== "string") {
+    return "claude";
+  }
+
+  const normalized = value.trim().toLowerCase();
+  return MODEL_PROVIDERS.includes(normalized) ? normalized : "claude";
+};
+
+/**
+ * Resolves the model a command should report.
+ *
+ * `context.model` is what the composer would send right now, so it stands in
+ * for a chat that has no session row yet; the service prefers the session's own
+ * recorded model whenever there is one.
+ */
+const resolveCommandModel = async (modelsService, provider, context) => {
+  const resolved = await modelsService.resolveSessionModel(provider, {
+    sessionId: context?.sessionId,
+    requestedModel: context?.model,
+  });
+  return resolved.model;
+};
+
+const executeModelsCommand = async (args, context, modelsService) => {
+  const currentProvider = readModelProvider(context?.provider);
+  const catalog = await modelsService.getProviderModels(currentProvider);
+  const currentModel = await resolveCommandModel(modelsService, currentProvider, context);
+  const availableModels = catalog.OPTIONS.map((option) => option.value);
+  const availableOptions = catalog.OPTIONS.map((option) => ({
+    value: option.value,
+    label: option.label,
+    description: option.description,
+    recordId: option.recordId,
+    isCustom: option.isCustom,
+  }));
+
+  return {
+    type: "builtin",
+    action: "models",
+    data: {
+      current: {
+        provider: currentProvider,
+        providerLabel: MODEL_PROVIDER_LABELS[currentProvider],
+        model: currentModel,
+      },
+      available: {
+        [currentProvider]: availableModels,
+      },
+      availableModels,
+      availableOptions,
+      defaultModel: catalog.DEFAULT,
+      message: `Current model: ${currentModel}`,
+    },
+  };
+};
+
+/**
+ * Recursively scan directory for command files (.md)
+ * @param {string} dir - Directory to scan
+ * @param {string} baseDir - Base directory for relative paths
+ * @param {string} namespace - Namespace for commands (e.g., 'project', 'user')
+ * @returns {Promise<Array>} Array of command objects
+ */
+async function scanCommandsDirectory(dir, baseDir, namespace) {
+  const commands = [];
+
+  try {
+    // Check if directory exists
+    await fs.access(dir);
+
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+
+      if (entry.isDirectory()) {
+        // Recursively scan subdirectories
+        const subCommands = await scanCommandsDirectory(
+          fullPath,
+          baseDir,
+          namespace,
+        );
+        commands.push(...subCommands);
+      } else if (entry.isFile() && entry.name.endsWith(".md")) {
+        // Parse markdown file for metadata
+        try {
+          const content = await fs.readFile(fullPath, "utf8");
+          const { data: frontmatter, content: commandContent } =
+            parseFrontMatter(content);
+
+          // Calculate relative path from baseDir for command name
+          const relativePath = path.relative(baseDir, fullPath);
+          // Remove .md extension and convert to command name
+          const commandName =
+            "/" + relativePath.replace(/\.md$/, "").replace(/\\/g, "/");
+
+          // Extract description from frontmatter or first line of content
+          let description = frontmatter.description || "";
+          if (!description) {
+            const firstLine = commandContent.trim().split("\n")[0];
+            description = firstLine.replace(/^#+\s*/, "").trim();
+          }
+
+          commands.push({
+            name: commandName,
+            path: fullPath,
+            relativePath,
+            description,
+            namespace,
+            metadata: frontmatter,
+          });
+        } catch (err) {
+          console.error(`Error parsing command file ${fullPath}:`, err.message);
+        }
+      }
+    }
+  } catch (err) {
+    // Directory doesn't exist or can't be accessed - this is okay
+    if (err.code !== "ENOENT" && err.code !== "EACCES") {
+      console.error(`Error scanning directory ${dir}:`, err.message);
+    }
+  }
+
+  return commands;
+}
+
+/**
+ * Built-in commands that are always available
+ */
+const builtInCommands = [
+  {
+    name: "/help",
+    description: "Show help documentation for Claude Code",
+    namespace: "builtin",
+    metadata: { type: "builtin" },
+  },
+  {
+    name: "/models",
+    description: "View available models for the current provider",
+    namespace: "builtin",
+    metadata: { type: "builtin" },
+  },
+  {
+    name: "/cost",
+    description: "Display token usage information",
+    namespace: "builtin",
+    metadata: { type: "builtin" },
+  },
+  {
+    name: "/memory",
+    description: "Open CLAUDE.md memory file for editing",
+    namespace: "builtin",
+    metadata: { type: "builtin" },
+  },
+  {
+    name: "/config",
+    description: "Open settings and configuration",
+    namespace: "builtin",
+    metadata: { type: "builtin" },
+  },
+  {
+    name: "/status",
+    description: "Show system status and version information",
+    namespace: "builtin",
+    metadata: { type: "builtin" },
+  },
+];
+
+const codexNativeCommands = [
+  {
+    name: "/plan",
+    description: "Toggle Codex plan mode; add a prompt to plan immediately",
+    namespace: "builtin",
+    metadata: { type: "provider", provider: "codex", passthrough: true },
+  },
+  {
+    name: "/review",
+    description: "Review uncommitted changes with Codex",
+    namespace: "builtin",
+    metadata: { type: "provider", provider: "codex", passthrough: true },
+  },
+  {
+    name: "/compact",
+    description: "Compact the current Codex thread context",
+    namespace: "builtin",
+    metadata: { type: "provider", provider: "codex", passthrough: true },
+  },
+  {
+    name: "/model",
+    description: "Select the Codex model used by this conversation",
+    namespace: "builtin",
+    metadata: { type: "provider", provider: "codex" },
+  },
+  {
+    name: "/mcp",
+    description: "Open settings to configure MCP servers",
+    namespace: "builtin",
+    metadata: { type: "provider", provider: "codex" },
+  },
+];
+
+/**
+ * Built-in command handlers
+ * Each handler returns { type: 'builtin', action: string, data: any }
+ */
+const builtInHandlers = {
+  "/help": async (args, context) => {
+    const isCodex = readModelProvider(context?.provider) === "codex";
+    const helpCommands = isCodex
+      ? [...builtInCommands, ...codexNativeCommands]
+      : builtInCommands;
+    const helpText = `# ${isCodex ? "Codex and CloudCLI" : "CloudCLI"} Commands
+
+## Built-in Commands
+
+${helpCommands
+  .map(
+    (cmd) => `### ${cmd.name}
+${cmd.description}
+`,
+  )
+  .join("\n")}
+
+## Custom Commands
+
+Custom commands can be created in:
+- Project: \`.claude/commands/\` (project-specific)
+- User: \`~/.claude/commands/\` (available in all projects)
+
+### Command Syntax
+
+- **Arguments**: Use \`$ARGUMENTS\` for all args or \`$1\`, \`$2\`, etc. for positional
+- **File Includes**: Use \`@filename\` to include file contents
+- **Bash Commands**: Use \`!command\` to execute bash commands
+
+### Examples
+
+\`\`\`markdown
+/mycommand arg1 arg2
+\`\`\`
+`;
+
+    return {
+      type: "builtin",
+      action: "help",
+      data: {
+        content: helpText,
+        format: "markdown",
+        commands: helpCommands.map((command) => ({
+          name: command.name,
+          description: command.description,
+          namespace: command.namespace,
+        })),
+      },
+    };
+  },
+
+  "/models": (args, context) => executeModelsCommand(args, context, providerModelsService),
+  "/model": (args, context) => executeModelsCommand(args, context, providerModelsService),
+
+  "/cost": async (args, context) => {
+    const tokenUsage = context?.tokenUsage || {};
+    const provider = readModelProvider(context?.provider);
+    const model = await resolveCommandModel(providerModelsService, provider, context);
+
+    const reportedUsed =
+      Number(
+        tokenUsage.used ?? tokenUsage.totalUsed ?? tokenUsage.total_tokens ?? 0,
+      ) || 0;
+    const total =
+      Number(
+        tokenUsage.total ??
+          tokenUsage.contextWindow ??
+          0,
+      ) || 0;
+    const normalizedInputValue =
+      tokenUsage.inputTokens ??
+      tokenUsage.input ??
+      tokenUsage.cumulativeInputTokens ??
+      tokenUsage.breakdown?.input ??
+      tokenUsage.promptTokens;
+    const directInputTokens =
+      Number(
+        normalizedInputValue ??
+          tokenUsage.input_tokens ??
+          0
+      ) || 0;
+    const cacheReadTokens =
+      Number(
+        tokenUsage.cacheReadTokens ??
+          tokenUsage.cache_read_input_tokens ??
+          tokenUsage.cacheReadInputTokens ??
+          0,
+      ) || 0;
+    const cacheCreationTokens =
+      Number(
+        tokenUsage.cacheCreationTokens ??
+          tokenUsage.cache_creation_input_tokens ??
+          tokenUsage.cacheCreationInputTokens ??
+          0,
+      ) || 0;
+    const inputTokens = normalizedInputValue == null
+      ? directInputTokens + cacheReadTokens + cacheCreationTokens
+      : directInputTokens;
+    const outputTokens =
+      Number(
+        tokenUsage.outputTokens ??
+          tokenUsage.output ??
+          tokenUsage.output_tokens ??
+          tokenUsage.cumulativeOutputTokens ??
+          tokenUsage.breakdown?.output ??
+          tokenUsage.completionTokens ??
+          0,
+      ) || 0;
+    const computedUsed = inputTokens + outputTokens;
+    const hasTokenBreakdown = computedUsed > 0;
+    const used = Math.max(reportedUsed, computedUsed);
+
+    return {
+      type: "builtin",
+      action: "cost",
+      data: {
+        tokenUsage: {
+          used,
+          total,
+        },
+        ...(hasTokenBreakdown
+          ? {
+              tokenBreakdown: {
+                input: inputTokens,
+                output: outputTokens,
+              },
+            }
+          : {}),
+        provider,
+        model,
+      },
+    };
+  },
+
+  "/status": async (args, context) => {
+    // Read version from package.json
+    const packageJsonPath = path.join(APP_ROOT, "package.json");
+    let version = "unknown";
+    let packageName = "claude-code-ui";
+
+    try {
+      const packageJson = JSON.parse(
+        await fs.readFile(packageJsonPath, "utf8"),
+      );
+      version = packageJson.version;
+      packageName = packageJson.name;
+    } catch (err) {
+      console.error("Error reading package.json:", err);
+    }
+
+    const uptime = process.uptime();
+    const uptimeMinutes = Math.floor(uptime / 60);
+    const uptimeHours = Math.floor(uptimeMinutes / 60);
+    const uptimeFormatted =
+      uptimeHours > 0
+        ? `${uptimeHours}h ${uptimeMinutes % 60}m`
+        : `${uptimeMinutes}m`;
+
+    const statusProvider = readModelProvider(context?.provider);
+    const model = await resolveCommandModel(providerModelsService, statusProvider, context);
+    const memoryUsage = process.memoryUsage();
+
+    return {
+      type: "builtin",
+      action: "status",
+      data: {
+        version,
+        packageName,
+        uptime: uptimeFormatted,
+        uptimeSeconds: Math.floor(uptime),
+        model,
+        provider: statusProvider,
+        nodeVersion: process.version,
+        platform: process.platform,
+        pid: process.pid,
+        memoryUsage: {
+          rssMb: Math.round(memoryUsage.rss / 1024 / 1024),
+          heapUsedMb: Math.round(memoryUsage.heapUsed / 1024 / 1024),
+          heapTotalMb: Math.round(memoryUsage.heapTotal / 1024 / 1024),
+        },
+      },
+    };
+  },
+
+  "/memory": async (args, context) => {
+    const projectPath = context?.projectPath;
+
+    if (!projectPath) {
+      return {
+        type: "builtin",
+        action: "memory",
+        data: {
+          error: "No project selected",
+          message: "Please select a project to access its CLAUDE.md file",
+        },
+      };
+    }
+
+    const claudeMdPath = path.join(projectPath, "CLAUDE.md");
+
+    // Check if CLAUDE.md exists
+    let exists = false;
+    try {
+      await fs.access(claudeMdPath);
+      exists = true;
+    } catch (err) {
+      // File doesn't exist
+    }
+
+    return {
+      type: "builtin",
+      action: "memory",
+      data: {
+        path: claudeMdPath,
+        exists,
+        message: exists
+          ? `Opening CLAUDE.md at ${claudeMdPath}`
+          : `CLAUDE.md not found at ${claudeMdPath}. Create it to store project-specific instructions.`,
+      },
+    };
+  },
+
+  "/config": async (args, context) => {
+    return {
+      type: "builtin",
+      action: "config",
+      data: {
+        message: "Opening settings...",
+      },
+    };
+  },
+  "/mcp": async () => ({
+    type: "builtin",
+    action: "config",
+    data: {
+      message: "Opening MCP settings...",
+    },
+  }),
+};
+
+/**
+ * POST /api/commands/list
+ * List all available commands from project and user directories
+ */
+router.post("/list", async (req, res) => {
+  try {
+    const projectPath = typeof req.body?.projectPath === "string"
+      ? req.body.projectPath
+      : "";
+    const provider = readModelProvider(req.body?.provider);
+    const providerBuiltInCommands = provider === "codex"
+      ? [...builtInCommands, ...codexNativeCommands]
+      : builtInCommands;
+    const allCommands = [...providerBuiltInCommands];
+
+    // Scan project-level commands (.claude/commands/)
+    if (projectPath) {
+      const projectCommandsDir = path.join(projectPath, ".claude", "commands");
+      const projectCommands = await scanCommandsDirectory(
+        projectCommandsDir,
+        projectCommandsDir,
+        "project",
+      );
+      allCommands.push(...projectCommands);
+    }
+
+    // Scan user-level commands (~/.claude/commands/)
+    const homeDir = os.homedir();
+    const userCommandsDir = path.join(homeDir, ".claude", "commands");
+    const userCommands = await scanCommandsDirectory(
+      userCommandsDir,
+      userCommandsDir,
+      "user",
+    );
+    allCommands.push(...userCommands);
+
+    // Separate built-in and custom commands
+    const customCommands = allCommands.filter(
+      (cmd) => cmd.namespace !== "builtin",
+    );
+
+    // Sort commands alphabetically by name
+    customCommands.sort((a, b) => a.name.localeCompare(b.name));
+
+    res.json({
+      builtIn: providerBuiltInCommands,
+      custom: customCommands,
+      count: allCommands.length,
+    });
+  } catch (error) {
+    console.error("Error listing commands:", error);
+    res.status(500).json({
+      error: "Failed to list commands",
+      message: error.message,
+    });
+  }
+});
+
+/**
+ * POST /api/commands/execute
+ * Execute a command with argument replacement
+ * This endpoint prepares the command content but doesn't execute bash commands yet
+ * (that will be handled in the command parser utility)
+ */
+router.post("/execute", async (req, res) => {
+  try {
+    const { commandName, commandPath, args = [], context = {} } = req.body;
+
+    if (!commandName) {
+      return res.status(400).json({
+        error: "Command name is required",
+      });
+    }
+
+    // Handle built-in commands
+    const handler = builtInHandlers[commandName];
+    if (handler) {
+      try {
+        const result = await handler(args, context);
+        return res.json({
+          ...result,
+          command: commandName,
+        });
+      } catch (error) {
+        console.error(
+          `Error executing built-in command ${commandName}:`,
+          error,
+        );
+        return res.status(500).json({
+          error: "Command execution failed",
+          message: error.message,
+          command: commandName,
+        });
+      }
+    }
+
+    // Handle custom commands
+    if (!commandPath) {
+      return res.status(400).json({
+        error: "Command path is required for custom commands",
+      });
+    }
+
+    // Load command content
+    // Security: validate commandPath is within allowed directories
+    {
+      const resolvedPath = path.resolve(commandPath);
+      const userBase = path.resolve(
+        path.join(os.homedir(), ".claude", "commands"),
+      );
+      const projectBase = context?.projectPath
+        ? path.resolve(path.join(context.projectPath, ".claude", "commands"))
+        : null;
+      const isUnder = (base) => {
+        const rel = path.relative(base, resolvedPath);
+        return rel !== "" && !rel.startsWith("..") && !path.isAbsolute(rel);
+      };
+      if (!(isUnder(userBase) || (projectBase && isUnder(projectBase)))) {
+        return res.status(403).json({
+          error: "Access denied",
+          message: "Command must be in .claude/commands directory",
+        });
+      }
+    }
+    const content = await fs.readFile(commandPath, "utf8");
+    const { data: metadata, content: commandContent } =
+      parseFrontMatter(content);
+    // Basic argument replacement (will be enhanced in command parser utility)
+    let processedContent = commandContent;
+
+    // Replace $ARGUMENTS with all arguments joined
+    const argsString = args.join(" ");
+    processedContent = processedContent.replace(/\$ARGUMENTS/g, argsString);
+
+    // Replace $1, $2, etc. with positional arguments
+    args.forEach((arg, index) => {
+      const placeholder = `$${index + 1}`;
+      processedContent = processedContent.replace(
+        new RegExp(`\\${placeholder}\\b`, "g"),
+        arg,
+      );
+    });
+
+    res.json({
+      type: "custom",
+      command: commandName,
+      content: processedContent,
+      metadata,
+      hasFileIncludes: processedContent.includes("@"),
+      hasBashCommands: processedContent.includes("!"),
+    });
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return res.status(404).json({
+        error: "Command not found",
+        message: `Command file not found: ${req.body.commandPath}`,
+      });
+    }
+
+    console.error("Error executing command:", error);
+    res.status(500).json({
+      error: "Failed to execute command",
+      message: error.message,
+    });
+  }
+});
+
+return router;
+}

package/server/modules/commands/index.ts

@@ -0,0 +1,2 @@
+// commandsRoutes: used by the server entrypoint to mount protected slash-command endpoints.
+export { commandsRoutes } from './commands.module.js';