@robota-sdk/agent-cli 3.0.0-beta.23 → 3.0.0-beta.25

package/dist/node/{chunk-EFSOR6D7.js → chunk-GJ3LG37H.js}

@@ -1,6 +1,6 @@
 // src/cli.ts
 import { readFileSync as readFileSync3, existsSync as existsSync3, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
-import { join as join3, dirname as dirname2 } from "path";
+import { join as join5, dirname as dirname3 } from "path";
 import { fileURLToPath } from "url";
 import {
   loadConfig,
@@ -369,7 +369,122 @@ function handleReset(addMessage) {
   }
   return { handled: true, exitRequested: true };
 }
-async function executeSlashCommand(cmd, args, session, addMessage, clearMessages, registry) {
+async function handlePluginCommand(args, addMessage, callbacks) {
+  const parts = args.trim().split(/\s+/);
+  const subcommand = parts[0] ?? "";
+  const subArgs = parts.slice(1).join(" ").trim();
+  try {
+    switch (subcommand) {
+      case "":
+      case void 0: {
+        const plugins = await callbacks.listInstalled();
+        if (plugins.length === 0) {
+          addMessage({ role: "system", content: "No plugins installed." });
+        } else {
+          const lines = plugins.map(
+            (p) => `  ${p.name} \u2014 ${p.description} [${p.enabled ? "enabled" : "disabled"}]`
+          );
+          addMessage({ role: "system", content: `Installed plugins:
+${lines.join("\n")}` });
+        }
+        return { handled: true };
+      }
+      case "install": {
+        if (!subArgs) {
+          addMessage({ role: "system", content: "Usage: /plugin install <name>@<marketplace>" });
+          return { handled: true };
+        }
+        await callbacks.install(subArgs);
+        addMessage({ role: "system", content: `Installed plugin: ${subArgs}` });
+        return { handled: true };
+      }
+      case "uninstall": {
+        if (!subArgs) {
+          addMessage({ role: "system", content: "Usage: /plugin uninstall <name>@<marketplace>" });
+          return { handled: true };
+        }
+        await callbacks.uninstall(subArgs);
+        addMessage({ role: "system", content: `Uninstalled plugin: ${subArgs}` });
+        return { handled: true };
+      }
+      case "enable": {
+        if (!subArgs) {
+          addMessage({ role: "system", content: "Usage: /plugin enable <name>@<marketplace>" });
+          return { handled: true };
+        }
+        await callbacks.enable(subArgs);
+        addMessage({ role: "system", content: `Enabled plugin: ${subArgs}` });
+        return { handled: true };
+      }
+      case "disable": {
+        if (!subArgs) {
+          addMessage({ role: "system", content: "Usage: /plugin disable <name>@<marketplace>" });
+          return { handled: true };
+        }
+        await callbacks.disable(subArgs);
+        addMessage({ role: "system", content: `Disabled plugin: ${subArgs}` });
+        return { handled: true };
+      }
+      case "marketplace": {
+        const mpParts = subArgs.split(/\s+/);
+        const mpSubcommand = mpParts[0] ?? "";
+        const mpArgs = mpParts.slice(1).join(" ").trim();
+        if (mpSubcommand === "add" && mpArgs) {
+          const registeredName = await callbacks.marketplaceAdd(mpArgs);
+          addMessage({
+            role: "system",
+            content: `Added marketplace: "${registeredName}" (from ${mpArgs})
+Install plugins with: /plugin install <name>@${registeredName}`
+          });
+          return { handled: true };
+        } else if (mpSubcommand === "remove" && mpArgs) {
+          await callbacks.marketplaceRemove(mpArgs);
+          addMessage({
+            role: "system",
+            content: `Removed marketplace "${mpArgs}" and uninstalled its plugins.`
+          });
+          return { handled: true };
+        } else if (mpSubcommand === "update" && mpArgs) {
+          await callbacks.marketplaceUpdate(mpArgs);
+          addMessage({
+            role: "system",
+            content: `Updated marketplace "${mpArgs}".`
+          });
+          return { handled: true };
+        } else if (mpSubcommand === "list") {
+          const sources = await callbacks.marketplaceList();
+          if (sources.length === 0) {
+            addMessage({ role: "system", content: "No marketplace sources configured." });
+          } else {
+            const lines = sources.map((s) => `  ${s.name} (${s.type})`);
+            addMessage({ role: "system", content: `Marketplace sources:
+${lines.join("\n")}` });
+          }
+          return { handled: true };
+        } else {
+          addMessage({
+            role: "system",
+            content: "Usage: /plugin marketplace add <source> | remove <name> | update <name> | list"
+          });
+          return { handled: true };
+        }
+      }
+      default:
+        addMessage({ role: "system", content: `Unknown plugin subcommand: ${subcommand}` });
+        return { handled: true };
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    addMessage({ role: "system", content: `Plugin error: ${message}` });
+    return { handled: true };
+  }
+}
+async function handleReloadPlugins(addMessage, callbacks) {
+  await callbacks.reloadPlugins();
+  addMessage({ role: "system", content: "Plugins reload complete." });
+  return { handled: true };
+}
+async function executeSlashCommand(cmd, args, session, addMessage, clearMessages, registry, pluginCallbacks) {
   switch (cmd) {
     case "help":
       return handleHelp(addMessage);
@@ -393,10 +508,22 @@ async function executeSlashCommand(cmd, args, session, addMessage, clearMessages
       return handleReset(addMessage);
     case "exit":
       return { handled: true, exitRequested: true };
+    case "plugin":
+      if (pluginCallbacks) {
+        return handlePluginCommand(args, addMessage, pluginCallbacks);
+      }
+      addMessage({ role: "system", content: "Plugin management is not available." });
+      return { handled: true };
+    case "reload-plugins":
+      if (pluginCallbacks) {
+        return handleReloadPlugins(addMessage, pluginCallbacks);
+      }
+      addMessage({ role: "system", content: "Plugin management is not available." });
+      return { handled: true };
     default: {
-      const skillCmd = registry.getCommands().find((c) => c.name === cmd && c.source === "skill");
-      if (skillCmd) {
-        addMessage({ role: "system", content: `Invoking skill: ${cmd}` });
+      const dynamicCmd = registry.getCommands().find((c) => c.name === cmd && (c.source === "skill" || c.source === "plugin"));
+      if (dynamicCmd) {
+        addMessage({ role: "system", content: `Invoking ${dynamicCmd.source}: ${cmd}` });
         return { handled: false };
       }
       addMessage({ role: "system", content: `Unknown command "/${cmd}". Type /help for help.` });
@@ -407,14 +534,22 @@ async function executeSlashCommand(cmd, args, session, addMessage, clearMessages
 
 // src/ui/hooks/useSlashCommands.ts
 var EXIT_DELAY_MS = 500;
-function useSlashCommands(session, addMessage, setMessages, exit, registry, pendingModelChangeRef, setPendingModelId) {
+function useSlashCommands(session, addMessage, setMessages, exit, registry, pendingModelChangeRef, setPendingModelId, pluginCallbacks) {
   return useCallback3(
     async (input) => {
       const parts = input.slice(1).split(/\s+/);
       const cmd = parts[0]?.toLowerCase() ?? "";
       const args = parts.slice(1).join(" ");
       const clearMessages = () => setMessages([]);
-      const result = await executeSlashCommand(cmd, args, session, addMessage, clearMessages, registry);
+      const result = await executeSlashCommand(
+        cmd,
+        args,
+        session,
+        addMessage,
+        clearMessages,
+        registry,
+        pluginCallbacks
+      );
       if (result.pendingModelId) {
         pendingModelChangeRef.current = result.pendingModelId;
         setPendingModelId(result.pendingModelId);
@@ -424,7 +559,16 @@ function useSlashCommands(session, addMessage, setMessages, exit, registry, pend
       }
       return result.handled;
     },
-    [session, addMessage, setMessages, exit, registry, pendingModelChangeRef, setPendingModelId]
+    [
+      session,
+      addMessage,
+      setMessages,
+      exit,
+      registry,
+      pendingModelChangeRef,
+      setPendingModelId,
+      pluginCallbacks
+    ]
   );
 }
 
@@ -459,16 +603,60 @@ function parseFirstArgValue(argsJson) {
 }
 
 // src/utils/skill-prompt.ts
-function buildSkillPrompt(input, registry) {
+import { execSync } from "child_process";
+function substituteVariables(content, args, context) {
+  const argParts = args ? args.split(/\s+/) : [];
+  let result = content;
+  result = result.replace(/\$ARGUMENTS\[(\d+)]/g, (_match, index) => {
+    return argParts[Number(index)] ?? "";
+  });
+  result = result.replace(/\$ARGUMENTS/g, args);
+  result = result.replace(/\$(\d)(?!\d|\w|\[)/g, (_match, digit) => {
+    return argParts[Number(digit)] ?? "";
+  });
+  result = result.replace(/\$\{CLAUDE_SESSION_ID}/g, context?.sessionId ?? "");
+  result = result.replace(/\$\{CLAUDE_SKILL_DIR}/g, context?.skillDir ?? "");
+  return result;
+}
+async function preprocessShellCommands(content) {
+  const shellPattern = /!`([^`]+)`/g;
+  if (!shellPattern.test(content)) {
+    return content;
+  }
+  shellPattern.lastIndex = 0;
+  let result = content;
+  let match;
+  const matches = [];
+  while ((match = shellPattern.exec(content)) !== null) {
+    matches.push({ full: match[0], command: match[1] });
+  }
+  for (const { full, command } of matches) {
+    let output = "";
+    try {
+      output = execSync(command, {
+        timeout: 5e3,
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "pipe"]
+      }).trimEnd();
+    } catch {
+      output = "";
+    }
+    result = result.replace(full, output);
+  }
+  return result;
+}
+async function buildSkillPrompt(input, registry, context) {
   const parts = input.slice(1).split(/\s+/);
   const cmd = parts[0]?.toLowerCase() ?? "";
-  const skillCmd = registry.getCommands().find((c) => c.name === cmd && c.source === "skill");
+  const skillCmd = registry.getCommands().find((c) => c.name === cmd && (c.source === "skill" || c.source === "plugin"));
   if (!skillCmd) return null;
   const args = parts.slice(1).join(" ").trim();
   const userInstruction = args || skillCmd.description;
   if (skillCmd.skillContent) {
+    let processed = await preprocessShellCommands(skillCmd.skillContent);
+    processed = substituteVariables(processed, args, context);
     return `<skill name="${cmd}">
-${skillCmd.skillContent}
+${processed}
 </skill>
 
 Execute the "${cmd}" skill: ${userInstruction}`;
@@ -481,12 +669,12 @@ function syncContextState(session, setter) {
   const ctx = session.getContextState();
   setter({ percentage: ctx.usedPercentage, usedTokens: ctx.usedTokens, maxTokens: ctx.maxTokens });
 }
-async function runSessionPrompt(prompt, session, addMessage, clearStreamingText, setIsThinking, setContextState) {
+async function runSessionPrompt(prompt, session, addMessage, clearStreamingText, setIsThinking, setContextState, rawInput) {
   setIsThinking(true);
   clearStreamingText();
   const historyBefore = session.getHistory().length;
   try {
-    const response = await session.run(prompt);
+    const response = await session.run(prompt, rawInput);
     clearStreamingText();
     const history = session.getHistory();
     const toolLines = extractToolCalls(
@@ -494,7 +682,11 @@ async function runSessionPrompt(prompt, session, addMessage, clearStreamingText,
       historyBefore
     );
     if (toolLines.length > 0) {
-      addMessage({ role: "tool", content: toolLines.join("\n"), toolName: `${toolLines.length} tools` });
+      addMessage({
+        role: "tool",
+        content: toolLines.join("\n"),
+        toolName: `${toolLines.length} tools`
+      });
     }
     addMessage({ role: "assistant", content: response || "(empty response)" });
     syncContextState(session, setContextState);
@@ -519,19 +711,45 @@ function useSubmitHandler(session, addMessage, handleSlashCommand, clearStreamin
           syncContextState(session, setContextState);
           return;
         }
-        const prompt = buildSkillPrompt(input, registry);
+        const prompt = await buildSkillPrompt(input, registry);
         if (!prompt) return;
-        return runSessionPrompt(prompt, session, addMessage, clearStreamingText, setIsThinking, setContextState);
+        return runSessionPrompt(
+          prompt,
+          session,
+          addMessage,
+          clearStreamingText,
+          setIsThinking,
+          setContextState,
+          input
+        );
       }
       addMessage({ role: "user", content: input });
-      return runSessionPrompt(input, session, addMessage, clearStreamingText, setIsThinking, setContextState);
+      return runSessionPrompt(
+        input,
+        session,
+        addMessage,
+        clearStreamingText,
+        setIsThinking,
+        setContextState
+      );
     },
-    [session, addMessage, handleSlashCommand, clearStreamingText, setIsThinking, setContextState, registry]
+    [
+      session,
+      addMessage,
+      handleSlashCommand,
+      clearStreamingText,
+      setIsThinking,
+      setContextState,
+      registry
+    ]
   );
 }
 
 // src/ui/hooks/useCommandRegistry.ts
 import { useRef as useRef2 } from "react";
+import { homedir as homedir2 } from "os";
+import { join as join3, dirname as dirname2 } from "path";
+import { BundlePluginLoader } from "@robota-sdk/agent-sdk";
 
 // src/commands/command-registry.ts
 var CommandRegistry = class {
@@ -615,6 +833,23 @@ function createBuiltinCommands() {
     { name: "cost", description: "Show session info", source: "builtin" },
     { name: "context", description: "Context window info", source: "builtin" },
     { name: "permissions", description: "Permission rules", source: "builtin" },
+    {
+      name: "plugin",
+      description: "Manage plugins",
+      source: "builtin",
+      subcommands: [
+        { name: "install", description: "Install a plugin (name@marketplace)", source: "builtin" },
+        {
+          name: "uninstall",
+          description: "Uninstall a plugin (name@marketplace)",
+          source: "builtin"
+        },
+        { name: "enable", description: "Enable a plugin (name@marketplace)", source: "builtin" },
+        { name: "disable", description: "Disable a plugin (name@marketplace)", source: "builtin" },
+        { name: "marketplace", description: "Manage marketplace sources", source: "builtin" }
+      ]
+    },
+    { name: "reload-plugins", description: "Reload all plugin resources", source: "builtin" },
     { name: "reset", description: "Delete settings and exit", source: "builtin" },
     { name: "exit", description: "Exit CLI", source: "builtin" }
   ];
@@ -632,27 +867,52 @@ var BuiltinCommandSource = class {
 
 // src/commands/skill-source.ts
 import { readdirSync, readFileSync as readFileSync2, existsSync as existsSync2 } from "fs";
-import { join as join2 } from "path";
+import { join as join2, basename } from "path";
 import { homedir } from "os";
+var BOOLEAN_KEYS = /* @__PURE__ */ new Set(["disable-model-invocation", "user-invocable"]);
+var LIST_KEYS = /* @__PURE__ */ new Set(["allowed-tools"]);
+function kebabToCamel(key) {
+  return key.replace(/-([a-z])/g, (_match, letter) => letter.toUpperCase());
+}
 function parseFrontmatter(content) {
   const lines = content.split("\n");
   if (lines[0]?.trim() !== "---") return null;
-  let name = "";
-  let description = "";
+  const result = {};
   for (let i = 1; i < lines.length; i++) {
     const line = lines[i];
     if (line.trim() === "---") break;
-    const nameMatch = line.match(/^name:\s*(.+)/);
-    if (nameMatch) {
-      name = nameMatch[1].trim();
-      continue;
-    }
-    const descMatch = line.match(/^description:\s*(.+)/);
-    if (descMatch) {
-      description = descMatch[1].trim();
+    const match = line.match(/^([a-z][a-z0-9-]*):\s*(.+)/);
+    if (!match) continue;
+    const key = match[1];
+    const rawValue = match[2].trim();
+    const camelKey = kebabToCamel(key);
+    if (BOOLEAN_KEYS.has(key)) {
+      result[camelKey] = rawValue === "true";
+    } else if (LIST_KEYS.has(key)) {
+      result[camelKey] = rawValue.split(",").map((s) => s.trim());
+    } else {
+      result[camelKey] = rawValue;
     }
   }
-  return name ? { name, description } : null;
+  return Object.keys(result).length > 0 ? result : null;
+}
+function buildCommand(frontmatter, content, fallbackName) {
+  const cmd = {
+    name: frontmatter?.name ?? fallbackName,
+    description: frontmatter?.description ?? `Skill: ${fallbackName}`,
+    source: "skill",
+    skillContent: content
+  };
+  if (frontmatter?.argumentHint !== void 0) cmd.argumentHint = frontmatter.argumentHint;
+  if (frontmatter?.disableModelInvocation !== void 0)
+    cmd.disableModelInvocation = frontmatter.disableModelInvocation;
+  if (frontmatter?.userInvocable !== void 0) cmd.userInvocable = frontmatter.userInvocable;
+  if (frontmatter?.allowedTools !== void 0) cmd.allowedTools = frontmatter.allowedTools;
+  if (frontmatter?.model !== void 0) cmd.model = frontmatter.model;
+  if (frontmatter?.effort !== void 0) cmd.effort = frontmatter.effort;
+  if (frontmatter?.context !== void 0) cmd.context = frontmatter.context;
+  if (frontmatter?.agent !== void 0) cmd.agent = frontmatter.agent;
+  return cmd;
 }
 function scanSkillsDir(skillsDir) {
   if (!existsSync2(skillsDir)) return [];
@@ -664,48 +924,251 @@ function scanSkillsDir(skillsDir) {
     if (!existsSync2(skillFile)) continue;
     const content = readFileSync2(skillFile, "utf-8");
     const frontmatter = parseFrontmatter(content);
-    commands.push({
-      name: frontmatter?.name ?? entry.name,
-      description: frontmatter?.description ?? `Skill: ${entry.name}`,
-      source: "skill",
-      skillContent: content
-    });
+    commands.push(buildCommand(frontmatter, content, entry.name));
+  }
+  return commands;
+}
+function scanCommandsDir(commandsDir) {
+  if (!existsSync2(commandsDir)) return [];
+  const commands = [];
+  const entries = readdirSync(commandsDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
+    const filePath = join2(commandsDir, entry.name);
+    const content = readFileSync2(filePath, "utf-8");
+    const frontmatter = parseFrontmatter(content);
+    const fallbackName = basename(entry.name, ".md");
+    commands.push(buildCommand(frontmatter, content, fallbackName));
   }
   return commands;
 }
 var SkillCommandSource = class {
   name = "skill";
   cwd;
+  home;
   cachedCommands = null;
-  constructor(cwd) {
+  constructor(cwd, home) {
     this.cwd = cwd;
+    this.home = home ?? homedir();
   }
   getCommands() {
     if (this.cachedCommands) return this.cachedCommands;
-    const projectSkills = scanSkillsDir(join2(this.cwd, ".agents", "skills"));
-    const userSkills = scanSkillsDir(join2(homedir(), ".claude", "skills"));
-    const seen = new Set(projectSkills.map((cmd) => cmd.name));
-    const merged = [...projectSkills];
-    for (const cmd of userSkills) {
-      if (!seen.has(cmd.name)) {
-        merged.push(cmd);
+    const sources = [
+      scanSkillsDir(join2(this.cwd, ".claude", "skills")),
+      // 1. project .claude/skills
+      scanCommandsDir(join2(this.cwd, ".claude", "commands")),
+      // 2. project .claude/commands (legacy)
+      scanSkillsDir(join2(this.home, ".robota", "skills")),
+      // 3. user ~/.robota/skills
+      scanSkillsDir(join2(this.cwd, ".agents", "skills"))
+      // 4. project .agents/skills
+    ];
+    const seen = /* @__PURE__ */ new Set();
+    const merged = [];
+    for (const commands of sources) {
+      for (const cmd of commands) {
+        if (!seen.has(cmd.name)) {
+          seen.add(cmd.name);
+          merged.push(cmd);
+        }
       }
     }
     this.cachedCommands = merged;
     return this.cachedCommands;
   }
+  /** Get skills that models can invoke (excludes disableModelInvocation: true) */
+  getModelInvocableSkills() {
+    return this.getCommands().filter((cmd) => cmd.disableModelInvocation !== true);
+  }
+  /** Get skills that users can invoke (excludes userInvocable: false) */
+  getUserInvocableSkills() {
+    return this.getCommands().filter((cmd) => cmd.userInvocable !== false);
+  }
+};
+
+// src/commands/plugin-source.ts
+var PluginCommandSource = class {
+  name = "plugin";
+  plugins;
+  constructor(plugins) {
+    this.plugins = plugins;
+  }
+  getCommands() {
+    const commands = [];
+    for (const plugin of this.plugins) {
+      for (const skill of plugin.skills) {
+        const baseName = skill.name.includes("@") ? skill.name.split("@")[0] : skill.name;
+        commands.push({
+          name: baseName,
+          description: `${skill.description} (${plugin.manifest.name})`,
+          source: "plugin",
+          skillContent: skill.skillContent,
+          pluginDir: plugin.pluginDir
+        });
+      }
+      for (const cmd of plugin.commands) {
+        commands.push({
+          name: cmd.name,
+          description: cmd.description,
+          source: "plugin",
+          skillContent: cmd.skillContent,
+          pluginDir: plugin.pluginDir
+        });
+      }
+    }
+    return commands;
+  }
 };
 
 // src/ui/hooks/useCommandRegistry.ts
+function buildPluginEnv(plugin) {
+  const dataDir = join3(dirname2(dirname2(plugin.pluginDir)), "data", plugin.manifest.name);
+  return {
+    CLAUDE_PLUGIN_ROOT: plugin.pluginDir,
+    CLAUDE_PLUGIN_PATH: plugin.pluginDir,
+    CLAUDE_PLUGIN_DATA: dataDir
+  };
+}
+function mergePluginHooks(plugins) {
+  const merged = {};
+  for (const plugin of plugins) {
+    const hooksObj = plugin.hooks;
+    if (!hooksObj) continue;
+    const pluginEnv = buildPluginEnv(plugin);
+    const innerHooks = hooksObj.hooks ?? hooksObj;
+    for (const [event, groups] of Object.entries(innerHooks)) {
+      if (!Array.isArray(groups)) continue;
+      if (!merged[event]) merged[event] = [];
+      const resolved = groups.map((group) => {
+        const resolved2 = resolvePluginRoot(group, plugin.pluginDir);
+        if (typeof resolved2 === "object" && resolved2 !== null) {
+          resolved2.env = pluginEnv;
+        }
+        return resolved2;
+      });
+      merged[event].push(...resolved);
+    }
+  }
+  return merged;
+}
+function resolvePluginRoot(group, pluginDir) {
+  if (typeof group !== "object" || group === null) return group;
+  const obj = group;
+  if (Array.isArray(obj.hooks)) {
+    return {
+      ...obj,
+      hooks: obj.hooks.map((h) => {
+        if (typeof h !== "object" || h === null) return h;
+        const hook = h;
+        if (typeof hook.command === "string") {
+          return {
+            ...hook,
+            command: hook.command.replace(/\$\{CLAUDE_PLUGIN_ROOT\}/g, pluginDir)
+          };
+        }
+        return hook;
+      })
+    };
+  }
+  return group;
+}
 function useCommandRegistry(cwd) {
-  const registryRef = useRef2(null);
-  if (registryRef.current === null) {
+  const resultRef = useRef2(null);
+  if (resultRef.current === null) {
     const registry = new CommandRegistry();
     registry.addSource(new BuiltinCommandSource());
     registry.addSource(new SkillCommandSource(cwd));
-    registryRef.current = registry;
+    let pluginHooks = {};
+    const pluginsDir = join3(homedir2(), ".robota", "plugins");
+    const loader = new BundlePluginLoader(pluginsDir);
+    try {
+      const plugins = loader.loadPluginsSync();
+      if (plugins.length > 0) {
+        registry.addSource(new PluginCommandSource(plugins));
+        pluginHooks = mergePluginHooks(plugins);
+      }
+    } catch {
+    }
+    resultRef.current = { registry, pluginHooks };
   }
-  return registryRef.current;
+  return resultRef.current;
+}
+
+// src/ui/hooks/usePluginCallbacks.ts
+import { useMemo } from "react";
+import { homedir as homedir3 } from "os";
+import { join as join4 } from "path";
+import {
+  PluginSettingsStore,
+  BundlePluginLoader as BundlePluginLoader2,
+  BundlePluginInstaller,
+  MarketplaceClient
+} from "@robota-sdk/agent-sdk";
+function usePluginCallbacks(cwd) {
+  return useMemo(() => {
+    const home = homedir3();
+    const pluginsDir = join4(home, ".robota", "plugins");
+    const userSettingsPath = join4(home, ".robota", "settings.json");
+    const settingsStore = new PluginSettingsStore(userSettingsPath);
+    const marketplace = new MarketplaceClient({ pluginsDir });
+    const installer = new BundlePluginInstaller({
+      pluginsDir,
+      settingsStore,
+      marketplaceClient: marketplace
+    });
+    const loader = new BundlePluginLoader2(pluginsDir);
+    return {
+      listInstalled: async () => {
+        const plugins = await loader.loadAll();
+        return plugins.map((p) => ({
+          name: p.manifest.name,
+          description: p.manifest.description,
+          enabled: true
+        }));
+      },
+      install: async (pluginId) => {
+        const [name, marketplaceName] = pluginId.split("@");
+        if (!name || !marketplaceName) {
+          throw new Error("Plugin ID must be in format: name@marketplace");
+        }
+        await installer.install(name, marketplaceName);
+      },
+      uninstall: async (pluginId) => {
+        await installer.uninstall(pluginId);
+      },
+      enable: async (pluginId) => {
+        await installer.enable(pluginId);
+      },
+      disable: async (pluginId) => {
+        await installer.disable(pluginId);
+      },
+      marketplaceAdd: async (source) => {
+        if (source.includes("/") && !source.includes(":")) {
+          return marketplace.addMarketplace({ type: "github", repo: source });
+        } else {
+          return marketplace.addMarketplace({ type: "git", url: source });
+        }
+      },
+      marketplaceRemove: async (name) => {
+        const installedFromMarketplace = installer.getPluginsByMarketplace(name);
+        for (const record of installedFromMarketplace) {
+          await installer.uninstall(`${record.pluginName}@${record.marketplace}`);
+        }
+        marketplace.removeMarketplace(name);
+      },
+      marketplaceUpdate: async (name) => {
+        marketplace.updateMarketplace(name);
+      },
+      marketplaceList: async () => {
+        return marketplace.listMarketplaces().map((m) => ({
+          name: m.name,
+          type: m.source.type
+        }));
+      },
+      reloadPlugins: async () => {
+      }
+    };
+  }, [cwd]);
 }
 
 // src/ui/MessageList.tsx
@@ -828,7 +1291,7 @@ function StatusBar({
 }
 
 // src/ui/InputArea.tsx
-import React3, { useState as useState5, useCallback as useCallback5, useMemo } from "react";
+import React4, { useState as useState5, useCallback as useCallback5, useMemo as useMemo2 } from "react";
 import { Box as Box4, Text as Text6, useInput as useInput2 } from "ink";
 
 // src/ui/CjkTextInput.tsx
@@ -1007,14 +1470,14 @@ function parseSlashInput(value) {
 function useAutocomplete(value, registry) {
   const [selectedIndex, setSelectedIndex] = useState5(0);
   const [dismissed, setDismissed] = useState5(false);
-  const prevValueRef = React3.useRef(value);
+  const prevValueRef = React4.useRef(value);
   if (prevValueRef.current !== value) {
     prevValueRef.current = value;
     if (dismissed) setDismissed(false);
   }
   const parsed = parseSlashInput(value);
   const isSubcommandMode = parsed.isSlash && parsed.parentCommand.length > 0;
-  const filteredCommands = useMemo(() => {
+  const filteredCommands = useMemo2(() => {
     if (!registry || !parsed.isSlash || dismissed) return [];
     if (isSubcommandMode) {
       const subs = registry.getSubcommands(parsed.parentCommand);
@@ -1174,7 +1637,7 @@ function ConfirmPrompt({
 }
 
 // src/ui/PermissionPrompt.tsx
-import React5 from "react";
+import React6 from "react";
 import { Box as Box6, Text as Text8, useInput as useInput4 } from "ink";
 import { jsx as jsx8, jsxs as jsxs6 } from "react/jsx-runtime";
 var OPTIONS = ["Allow", "Allow always (this session)", "Deny"];
@@ -1184,15 +1647,15 @@ function formatArgs(args) {
   return entries.map(([k, v]) => `${k}: ${typeof v === "string" ? v : JSON.stringify(v)}`).join(", ");
 }
 function PermissionPrompt({ request }) {
-  const [selected, setSelected] = React5.useState(0);
-  const resolvedRef = React5.useRef(false);
-  const prevRequestRef = React5.useRef(request);
+  const [selected, setSelected] = React6.useState(0);
+  const resolvedRef = React6.useRef(false);
+  const prevRequestRef = React6.useRef(request);
   if (prevRequestRef.current !== request) {
     prevRequestRef.current = request;
     resolvedRef.current = false;
     setSelected(0);
   }
-  const doResolve = React5.useCallback(
+  const doResolve = React6.useCallback(
     (index) => {
       if (resolvedRef.current) return;
       resolvedRef.current = true;
@@ -1271,9 +1734,35 @@ function StreamingIndicator({ text, activeTools }) {
 // src/ui/App.tsx
 import { jsx as jsx10, jsxs as jsxs8 } from "react/jsx-runtime";
 var EXIT_DELAY_MS2 = 500;
+function mergeHooksIntoConfig(configHooks, pluginHooks) {
+  const pluginKeys = Object.keys(pluginHooks);
+  if (pluginKeys.length === 0) return configHooks;
+  const merged = {};
+  for (const [event, groups] of Object.entries(pluginHooks)) {
+    merged[event] = [...groups];
+  }
+  if (configHooks) {
+    for (const [event, groups] of Object.entries(configHooks)) {
+      if (!Array.isArray(groups)) continue;
+      if (!merged[event]) merged[event] = [];
+      merged[event].push(...groups);
+    }
+  }
+  return merged;
+}
 function App(props) {
   const { exit } = useApp();
-  const { session, permissionRequest, streamingText, clearStreamingText, activeTools } = useSession(props);
+  const { registry, pluginHooks } = useCommandRegistry(props.cwd ?? process.cwd());
+  const configWithPluginHooks = {
+    ...props.config,
+    hooks: mergeHooksIntoConfig(
+      props.config.hooks,
+      pluginHooks
+    )
+  };
+  const { session, permissionRequest, streamingText, clearStreamingText, activeTools } = useSession(
+    { ...props, config: configWithPluginHooks }
+  );
   const { messages, setMessages, addMessage } = useMessages();
   const [isThinking, setIsThinking] = useState7(false);
   const initialCtx = session.getContextState();
@@ -1282,10 +1771,19 @@ function App(props) {
     usedTokens: initialCtx.usedTokens,
     maxTokens: initialCtx.maxTokens
   });
-  const registry = useCommandRegistry(props.cwd ?? process.cwd());
   const pendingModelChangeRef = useRef5(null);
   const [pendingModelId, setPendingModelId] = useState7(null);
-  const handleSlashCommand = useSlashCommands(session, addMessage, setMessages, exit, registry, pendingModelChangeRef, setPendingModelId);
+  const pluginCallbacks = usePluginCallbacks(props.cwd ?? process.cwd());
+  const handleSlashCommand = useSlashCommands(
+    session,
+    addMessage,
+    setMessages,
+    exit,
+    registry,
+    pendingModelChangeRef,
+    setPendingModelId,
+    pluginCallbacks
+  );
   const handleSubmit = useSubmitHandler(
     session,
     addMessage,
@@ -1332,10 +1830,16 @@ function App(props) {
             try {
               const settingsPath = getUserSettingsPath();
               updateModelInSettings(settingsPath, pendingModelId);
-              addMessage({ role: "system", content: `Model changed to ${getModelName(pendingModelId)}. Restarting...` });
+              addMessage({
+                role: "system",
+                content: `Model changed to ${getModelName(pendingModelId)}. Restarting...`
+              });
               setTimeout(() => exit(), EXIT_DELAY_MS2);
             } catch (err) {
-              addMessage({ role: "system", content: `Failed: ${err instanceof Error ? err.message : String(err)}` });
+              addMessage({
+                role: "system",
+                content: `Failed: ${err instanceof Error ? err.message : String(err)}`
+              });
             }
           } else {
             addMessage({ role: "system", content: "Model change cancelled." });
@@ -1393,23 +1897,24 @@ function renderApp(options) {
 }
 
 // src/cli.ts
-function hasValidSettingsFile(filePath) {
-  if (!existsSync3(filePath)) return false;
+function checkSettingsFile(filePath) {
+  if (!existsSync3(filePath)) return "missing";
   try {
     const raw = readFileSync3(filePath, "utf8").trim();
-    if (raw.length === 0) return false;
+    if (raw.length === 0) return "incomplete";
     const parsed = JSON.parse(raw);
     const provider = parsed.provider;
-    return !!provider?.apiKey;
+    if (!provider?.apiKey) return "incomplete";
+    return "valid";
   } catch {
-    return false;
+    return "corrupt";
   }
 }
 function readVersion() {
   try {
     const thisFile = fileURLToPath(import.meta.url);
-    const dir = dirname2(thisFile);
-    const candidates = [join3(dir, "..", "..", "package.json"), join3(dir, "..", "package.json")];
+    const dir = dirname3(thisFile);
+    const candidates = [join5(dir, "..", "..", "package.json"), join5(dir, "..", "package.json")];
     for (const pkgPath of candidates) {
       try {
         const raw = readFileSync3(pkgPath, "utf-8");
@@ -1462,14 +1967,36 @@ function promptInput(label, masked = false) {
 }
 async function ensureConfig(cwd) {
   const userPath = getUserSettingsPath();
-  const projectPath = join3(cwd, ".robota", "settings.json");
-  const localPath = join3(cwd, ".robota", "settings.local.json");
-  if (hasValidSettingsFile(userPath) || hasValidSettingsFile(projectPath) || hasValidSettingsFile(localPath)) {
+  const projectPath = join5(cwd, ".robota", "settings.json");
+  const localPath = join5(cwd, ".robota", "settings.local.json");
+  const paths = [userPath, projectPath, localPath];
+  const checks = paths.map((p) => ({ path: p, status: checkSettingsFile(p) }));
+  if (checks.some((c) => c.status === "valid")) {
     return;
   }
+  const corrupt = checks.filter((c) => c.status === "corrupt");
+  const incomplete = checks.filter((c) => c.status === "incomplete");
   process.stdout.write("\n");
-  process.stdout.write("  Welcome to Robota CLI!\n");
-  process.stdout.write("  No configuration found. Let's set up.\n");
+  if (corrupt.length > 0) {
+    for (const c of corrupt) {
+      process.stderr.write(`  ERROR: Settings file is corrupt (invalid JSON): ${c.path}
+`);
+    }
+    process.stdout.write("\n");
+  }
+  if (incomplete.length > 0) {
+    for (const c of incomplete) {
+      process.stderr.write(`  WARNING: Settings file is missing provider.apiKey: ${c.path}
+`);
+    }
+    process.stdout.write("\n");
+  }
+  if (corrupt.length === 0 && incomplete.length === 0) {
+    process.stdout.write("  Welcome to Robota CLI!\n");
+    process.stdout.write("  No configuration found. Let's set up.\n");
+  } else {
+    process.stdout.write("  Reconfiguring...\n");
+  }
   process.stdout.write("\n");
   const apiKey = await promptInput("  Anthropic API key: ", true);
   if (!apiKey) {
@@ -1477,7 +2004,7 @@ async function ensureConfig(cwd) {
     process.exit(1);
   }
   const language = await promptInput("  Response language (ko/en/ja/zh, default: en): ");
-  const settingsDir = dirname2(userPath);
+  const settingsDir = dirname3(userPath);
   mkdirSync2(settingsDir, { recursive: true });
   const settings = {
     provider: {