@robota-sdk/agent-sdk 3.0.0-beta.34 → 3.0.0-beta.36

package/dist/node/index.cjs

@@ -32,16 +32,21 @@ var index_exports = {};
 __export(index_exports, {
   AgentExecutor: () => AgentExecutor,
   BUILT_IN_AGENTS: () => BUILT_IN_AGENTS,
+  BuiltinCommandSource: () => BuiltinCommandSource,
   BundlePluginInstaller: () => BundlePluginInstaller,
   BundlePluginLoader: () => BundlePluginLoader,
+  CommandRegistry: () => CommandRegistry,
   DEFAULT_TOOL_DESCRIPTIONS: () => DEFAULT_TOOL_DESCRIPTIONS,
-  FileSessionLogger: () => import_agent_sessions5.FileSessionLogger,
+  FileSessionLogger: () => import_agent_sessions6.FileSessionLogger,
+  InteractiveSession: () => InteractiveSession,
   MarketplaceClient: () => MarketplaceClient,
   PluginSettingsStore: () => PluginSettingsStore,
   PromptExecutor: () => PromptExecutor,
-  Session: () => import_agent_sessions4.Session,
-  SessionStore: () => import_agent_sessions6.SessionStore,
-  SilentSessionLogger: () => import_agent_sessions5.SilentSessionLogger,
+  Session: () => import_agent_sessions5.Session,
+  SessionStore: () => import_agent_sessions7.SessionStore,
+  SilentSessionLogger: () => import_agent_sessions6.SilentSessionLogger,
+  SkillCommandSource: () => SkillCommandSource,
+  SystemCommandExecutor: () => SystemCommandExecutor,
   TRUST_TO_MODE: () => import_agent_core.TRUST_TO_MODE,
   assembleSubagentPrompt: () => assembleSubagentPrompt,
   bashTool: () => import_agent_tools3.bashTool,
@@ -52,9 +57,10 @@ __export(index_exports, {
   createSession: () => createSession,
   createSubagentLogger: () => createSubagentLogger,
   createSubagentSession: () => createSubagentSession,
+  createSystemCommands: () => createSystemCommands,
   detectProject: () => detectProject,
   editTool: () => import_agent_tools6.editTool,
-  evaluatePermission: () => import_agent_core2.evaluatePermission,
+  evaluatePermission: () => import_agent_core4.evaluatePermission,
   getBuiltInAgent: () => getBuiltInAgent,
   getForkWorkerSuffix: () => getForkWorkerSuffix,
   getSubagentSuffix: () => getSubagentSuffix,
@@ -62,13 +68,14 @@ __export(index_exports, {
   grepTool: () => import_agent_tools8.grepTool,
   loadConfig: () => loadConfig,
   loadContext: () => loadContext,
+  parseFrontmatter: () => parseFrontmatter2,
   projectPaths: () => projectPaths,
   promptForApproval: () => promptForApproval,
   query: () => query,
   readTool: () => import_agent_tools4.readTool,
   resolveSubagentLogDir: () => resolveSubagentLogDir,
   retrieveAgentToolDeps: () => retrieveAgentToolDeps,
-  runHooks: () => import_agent_core3.runHooks,
+  runHooks: () => import_agent_core5.runHooks,
   storeAgentToolDeps: () => storeAgentToolDeps,
   userPaths: () => userPaths,
   writeTool: () => import_agent_tools5.writeTool
@@ -753,9 +760,9 @@ function resolveSubagentLogDir(parentSessionId, baseLogsDir) {
 }
 
 // src/index.ts
-var import_agent_sessions4 = require("@robota-sdk/agent-sessions");
 var import_agent_sessions5 = require("@robota-sdk/agent-sessions");
 var import_agent_sessions6 = require("@robota-sdk/agent-sessions");
+var import_agent_sessions7 = require("@robota-sdk/agent-sessions");
 
 // src/config/config-loader.ts
 var import_fs = require("fs");
@@ -1150,8 +1157,8 @@ async function query(prompt, options) {
 }
 
 // src/index.ts
-var import_agent_core2 = require("@robota-sdk/agent-core");
-var import_agent_core3 = require("@robota-sdk/agent-core");
+var import_agent_core4 = require("@robota-sdk/agent-core");
+var import_agent_core5 = require("@robota-sdk/agent-core");
 
 // src/paths.ts
 var import_node_path3 = require("path");
@@ -1968,6 +1975,703 @@ var MarketplaceClient = class {
   }
 };
 
+// src/commands/command-registry.ts
+var CommandRegistry = class {
+  sources = [];
+  addSource(source) {
+    this.sources.push(source);
+  }
+  /** Get all commands, optionally filtered by prefix */
+  getCommands(filter) {
+    const all = [];
+    for (const source of this.sources) {
+      all.push(...source.getCommands());
+    }
+    if (!filter) return all;
+    const lower = filter.toLowerCase();
+    return all.filter((cmd) => cmd.name.toLowerCase().startsWith(lower));
+  }
+  /** Resolve a short name to its fully qualified plugin:name form */
+  resolveQualifiedName(shortName) {
+    const matches = this.getCommands().filter(
+      (c) => c.source === "plugin" && c.name.includes(":") && c.name.endsWith(`:${shortName}`)
+    );
+    if (matches.length !== 1) return null;
+    return matches[0].name;
+  }
+  /** Get subcommands for a specific command */
+  getSubcommands(commandName) {
+    const lower = commandName.toLowerCase();
+    for (const source of this.sources) {
+      for (const cmd of source.getCommands()) {
+        if (cmd.name.toLowerCase() === lower && cmd.subcommands) {
+          return cmd.subcommands;
+        }
+      }
+    }
+    return [];
+  }
+};
+
+// src/commands/builtin-source.ts
+var import_agent_core2 = require("@robota-sdk/agent-core");
+function buildModelSubcommands() {
+  const seen = /* @__PURE__ */ new Set();
+  const commands = [];
+  for (const model of Object.values(import_agent_core2.CLAUDE_MODELS)) {
+    if (seen.has(model.name)) continue;
+    seen.add(model.name);
+    commands.push({
+      name: model.id,
+      description: `${model.name} (${(0, import_agent_core2.formatTokenCount)(model.contextWindow).toUpperCase()})`,
+      source: "builtin"
+    });
+  }
+  return commands;
+}
+function createBuiltinCommands() {
+  return [
+    { name: "help", description: "Show available commands", source: "builtin" },
+    { name: "clear", description: "Clear conversation history", source: "builtin" },
+    {
+      name: "mode",
+      description: "Permission mode",
+      source: "builtin",
+      subcommands: [
+        { name: "plan", description: "Plan only, no execution", source: "builtin" },
+        { name: "default", description: "Ask before risky actions", source: "builtin" },
+        { name: "acceptEdits", description: "Auto-approve file edits", source: "builtin" },
+        { name: "bypassPermissions", description: "Skip all permission checks", source: "builtin" }
+      ]
+    },
+    {
+      name: "model",
+      description: "Select AI model",
+      source: "builtin",
+      subcommands: buildModelSubcommands()
+    },
+    {
+      name: "language",
+      description: "Set response language",
+      source: "builtin",
+      subcommands: [
+        { name: "ko", description: "Korean", source: "builtin" },
+        { name: "en", description: "English", source: "builtin" },
+        { name: "ja", description: "Japanese", source: "builtin" },
+        { name: "zh", description: "Chinese", source: "builtin" }
+      ]
+    },
+    { name: "compact", description: "Compress context window", source: "builtin" },
+    { 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" },
+    { 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" }
+  ];
+}
+var BuiltinCommandSource = class {
+  name = "builtin";
+  commands;
+  constructor() {
+    this.commands = createBuiltinCommands();
+  }
+  getCommands() {
+    return this.commands;
+  }
+};
+
+// src/commands/skill-source.ts
+var import_node_fs7 = require("fs");
+var import_node_path8 = require("path");
+var import_node_os3 = require("os");
+var BOOLEAN_KEYS = /* @__PURE__ */ new Set(["disable-model-invocation", "user-invocable"]);
+var LIST_KEYS2 = /* @__PURE__ */ new Set(["allowed-tools"]);
+function kebabToCamel(key) {
+  return key.replace(/-([a-z])/g, (_match, letter) => letter.toUpperCase());
+}
+function parseFrontmatter2(content) {
+  const lines = content.split("\n");
+  if (lines[0]?.trim() !== "---") return null;
+  const result = {};
+  for (let i = 1; i < lines.length; i++) {
+    const line = lines[i];
+    if (line.trim() === "---") break;
+    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_KEYS2.has(key)) {
+      result[camelKey] = rawValue.split(",").map((s) => s.trim());
+    } else {
+      result[camelKey] = rawValue;
+    }
+  }
+  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 (!(0, import_node_fs7.existsSync)(skillsDir)) return [];
+  const commands = [];
+  const entries = (0, import_node_fs7.readdirSync)(skillsDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const skillFile = (0, import_node_path8.join)(skillsDir, entry.name, "SKILL.md");
+    if (!(0, import_node_fs7.existsSync)(skillFile)) continue;
+    const content = (0, import_node_fs7.readFileSync)(skillFile, "utf-8");
+    const frontmatter = parseFrontmatter2(content);
+    commands.push(buildCommand(frontmatter, content, entry.name));
+  }
+  return commands;
+}
+function scanCommandsDir(commandsDir) {
+  if (!(0, import_node_fs7.existsSync)(commandsDir)) return [];
+  const commands = [];
+  const entries = (0, import_node_fs7.readdirSync)(commandsDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
+    const filePath = (0, import_node_path8.join)(commandsDir, entry.name);
+    const content = (0, import_node_fs7.readFileSync)(filePath, "utf-8");
+    const frontmatter = parseFrontmatter2(content);
+    const fallbackName = (0, import_node_path8.basename)(entry.name, ".md");
+    commands.push(buildCommand(frontmatter, content, fallbackName));
+  }
+  return commands;
+}
+var SkillCommandSource = class {
+  name = "skill";
+  cwd;
+  home;
+  cachedCommands = null;
+  constructor(cwd, home) {
+    this.cwd = cwd;
+    this.home = home ?? (0, import_node_os3.homedir)();
+  }
+  getCommands() {
+    if (this.cachedCommands) return this.cachedCommands;
+    const sources = [
+      scanSkillsDir((0, import_node_path8.join)(this.cwd, ".claude", "skills")),
+      scanCommandsDir((0, import_node_path8.join)(this.cwd, ".claude", "commands")),
+      scanSkillsDir((0, import_node_path8.join)(this.home, ".robota", "skills")),
+      scanSkillsDir((0, import_node_path8.join)(this.cwd, ".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;
+  }
+  getModelInvocableSkills() {
+    return this.getCommands().filter((cmd) => cmd.disableModelInvocation !== true);
+  }
+  getUserInvocableSkills() {
+    return this.getCommands().filter((cmd) => cmd.userInvocable !== false);
+  }
+};
+
+// src/commands/system-command.ts
+var VALID_MODES = ["plan", "default", "acceptEdits", "bypassPermissions"];
+function createSystemCommands() {
+  return [
+    {
+      name: "help",
+      description: "Show available commands",
+      execute: (_session, _args) => ({
+        message: [
+          "Available commands:",
+          "  help              \u2014 Show this help",
+          "  clear             \u2014 Clear conversation",
+          "  compact [instr]   \u2014 Compact context (optional focus instructions)",
+          "  mode [m]          \u2014 Show/change permission mode",
+          "  model <id>        \u2014 Change AI model",
+          "  language <code>   \u2014 Set response language (ko, en, ja, zh)",
+          "  cost              \u2014 Show session info",
+          "  context           \u2014 Context window info",
+          "  permissions       \u2014 Permission rules",
+          "  reset             \u2014 Delete settings and exit"
+        ].join("\n"),
+        success: true
+      })
+    },
+    {
+      name: "clear",
+      description: "Clear conversation history",
+      execute: (session, _args) => {
+        const underlying = session.getSession();
+        underlying.clearHistory();
+        return { message: "Conversation cleared.", success: true };
+      }
+    },
+    {
+      name: "compact",
+      description: "Compress context window",
+      execute: async (session, args) => {
+        const underlying = session.getSession();
+        const instructions = args.trim() || void 0;
+        const before = underlying.getContextState().usedPercentage;
+        await underlying.compact(instructions);
+        const after = underlying.getContextState().usedPercentage;
+        return {
+          message: `Context compacted: ${Math.round(before)}% -> ${Math.round(after)}%`,
+          success: true,
+          data: { before, after }
+        };
+      }
+    },
+    {
+      name: "mode",
+      description: "Show/change permission mode",
+      execute: (session, args) => {
+        const underlying = session.getSession();
+        const arg = args.trim().split(/\s+/)[0];
+        if (!arg) {
+          return {
+            message: `Current mode: ${underlying.getPermissionMode()}`,
+            success: true,
+            data: { mode: underlying.getPermissionMode() }
+          };
+        }
+        if (VALID_MODES.includes(arg)) {
+          underlying.setPermissionMode(arg);
+          return {
+            message: `Permission mode set to: ${arg}`,
+            success: true,
+            data: { mode: arg }
+          };
+        }
+        return {
+          message: `Invalid mode. Valid: ${VALID_MODES.join(" | ")}`,
+          success: false
+        };
+      }
+    },
+    {
+      name: "model",
+      description: "Change AI model",
+      execute: (_session, args) => {
+        const modelId = args.trim().split(/\s+/)[0];
+        if (!modelId) {
+          return { message: "Usage: model <model-id>", success: false };
+        }
+        return {
+          message: `Model change requested: ${modelId}`,
+          success: true,
+          data: { modelId }
+        };
+      }
+    },
+    {
+      name: "language",
+      description: "Set response language",
+      execute: (_session, args) => {
+        const lang = args.trim().split(/\s+/)[0];
+        if (!lang) {
+          return { message: "Usage: language <code> (e.g., ko, en, ja, zh)", success: false };
+        }
+        return {
+          message: `Language set to "${lang}".`,
+          success: true,
+          data: { language: lang }
+        };
+      }
+    },
+    {
+      name: "cost",
+      description: "Show session info",
+      execute: (session, _args) => {
+        const underlying = session.getSession();
+        const sessionId = underlying.getSessionId();
+        const messageCount = underlying.getMessageCount();
+        return {
+          message: `Session: ${sessionId}
+Messages: ${messageCount}`,
+          success: true,
+          data: { sessionId, messageCount }
+        };
+      }
+    },
+    {
+      name: "context",
+      description: "Context window info",
+      execute: (session, _args) => {
+        const ctx = session.getContextState();
+        return {
+          message: `Context: ${ctx.usedTokens.toLocaleString()} / ${ctx.maxTokens.toLocaleString()} tokens (${Math.round(ctx.usedPercentage)}%)`,
+          success: true,
+          data: {
+            usedTokens: ctx.usedTokens,
+            maxTokens: ctx.maxTokens,
+            percentage: ctx.usedPercentage
+          }
+        };
+      }
+    },
+    {
+      name: "permissions",
+      description: "Show permission rules",
+      execute: (session, _args) => {
+        const underlying = session.getSession();
+        const mode = underlying.getPermissionMode();
+        const sessionAllowed = underlying.getSessionAllowedTools();
+        const lines = [`Permission mode: ${mode}`];
+        if (sessionAllowed.length > 0) {
+          lines.push(`Session-approved tools: ${sessionAllowed.join(", ")}`);
+        } else {
+          lines.push("No session-approved tools.");
+        }
+        return {
+          message: lines.join("\n"),
+          success: true,
+          data: { mode, sessionAllowed }
+        };
+      }
+    },
+    {
+      name: "reset",
+      description: "Delete settings",
+      execute: (_session, _args) => {
+        return {
+          message: "Reset requested.",
+          success: true,
+          data: { resetRequested: true }
+        };
+      }
+    }
+  ];
+}
+var SystemCommandExecutor = class {
+  commands;
+  constructor(commands) {
+    this.commands = /* @__PURE__ */ new Map();
+    for (const cmd of commands ?? createSystemCommands()) {
+      this.commands.set(cmd.name, cmd);
+    }
+  }
+  /** Register an additional command. */
+  register(command) {
+    this.commands.set(command.name, command);
+  }
+  /** Execute a command by name. Returns null if command not found. */
+  async execute(name, session, args) {
+    const cmd = this.commands.get(name);
+    if (!cmd) return null;
+    return await cmd.execute(session, args);
+  }
+  /** List all registered commands. */
+  listCommands() {
+    return [...this.commands.values()];
+  }
+  /** Check if a command exists. */
+  hasCommand(name) {
+    return this.commands.has(name);
+  }
+};
+
+// src/interactive/interactive-session.ts
+var import_agent_sessions4 = require("@robota-sdk/agent-sessions");
+var import_agent_core3 = require("@robota-sdk/agent-core");
+var TOOL_ARG_DISPLAY_MAX = 80;
+var TAIL_KEEP = 30;
+var MAX_COMPLETED_TOOLS = 50;
+var STREAMING_FLUSH_INTERVAL_MS = 16;
+var InteractiveSession = class {
+  session;
+  listeners = /* @__PURE__ */ new Map();
+  // Streaming state
+  streamingText = "";
+  flushTimer = null;
+  // Tool state
+  activeTools = [];
+  // Execution state
+  executing = false;
+  pendingPrompt = null;
+  pendingDisplayInput;
+  pendingRawInput;
+  // Display messages (what clients render — not the raw session history)
+  messages = [];
+  constructor(options) {
+    if (options.session) {
+      this.session = options.session;
+    } else {
+      const cwd = options.cwd ?? process.cwd();
+      const paths = projectPaths(cwd);
+      this.session = createSession({
+        config: options.config,
+        context: options.context,
+        projectInfo: options.projectInfo,
+        sessionStore: options.sessionStore,
+        permissionMode: options.permissionMode,
+        maxTurns: options.maxTurns,
+        terminal: NOOP_TERMINAL,
+        sessionLogger: new import_agent_sessions4.FileSessionLogger(paths.logs),
+        permissionHandler: options.permissionHandler,
+        onTextDelta: (delta) => this.handleTextDelta(delta),
+        onToolExecution: (event) => this.handleToolExecution(event)
+      });
+    }
+  }
+  // ── Event system ──────────────────────────────────────────────
+  on(event, handler) {
+    if (!this.listeners.has(event)) {
+      this.listeners.set(event, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(event).add(handler);
+  }
+  off(event, handler) {
+    this.listeners.get(event)?.delete(handler);
+  }
+  emit(event, ...args) {
+    const handlers = this.listeners.get(event);
+    if (handlers) {
+      for (const handler of handlers) {
+        handler(...args);
+      }
+    }
+  }
+  // ── Public API ────────────────────────────────────────────────
+  /** Submit a prompt. Queues if already executing (max 1 queued).
+   *  displayInput overrides what appears as the user message (e.g., "/audit" instead of full skill prompt).
+   *  rawInput is passed to Session.run() for hook matching (e.g., "/rulebased-harness:audit"). */
+  async submit(input, displayInput, rawInput) {
+    if (this.executing) {
+      this.pendingPrompt = input;
+      this.pendingDisplayInput = displayInput;
+      this.pendingRawInput = rawInput;
+      return;
+    }
+    await this.executePrompt(input, displayInput, rawInput);
+  }
+  /** Abort current execution and clear queue. */
+  abort() {
+    this.pendingPrompt = null;
+    this.session.abort();
+  }
+  /** Cancel queued prompt without aborting current execution. */
+  cancelQueue() {
+    this.pendingPrompt = null;
+  }
+  isExecuting() {
+    return this.executing;
+  }
+  getPendingPrompt() {
+    return this.pendingPrompt;
+  }
+  getMessages() {
+    return this.messages;
+  }
+  getStreamingText() {
+    return this.streamingText;
+  }
+  getActiveTools() {
+    return this.activeTools;
+  }
+  getContextState() {
+    return this.session.getContextState();
+  }
+  getSession() {
+    return this.session;
+  }
+  // ── Execution ─────────────────────────────────────────────────
+  async executePrompt(input, displayInput, rawInput) {
+    this.executing = true;
+    this.clearStreaming();
+    this.emit("thinking", true);
+    this.messages.push((0, import_agent_core3.createUserMessage)(displayInput ?? input));
+    const historyBefore = this.session.getHistory().length;
+    try {
+      const response = await this.session.run(input, rawInput);
+      this.flushStreaming();
+      this.clearStreaming();
+      const result = this.buildResult(response || "(empty response)", historyBefore);
+      this.messages.push((0, import_agent_core3.createAssistantMessage)(result.response));
+      this.emit("complete", result);
+      this.emit("context_update", this.getContextState());
+    } catch (err) {
+      this.flushStreaming();
+      this.clearStreaming();
+      if (isAbortError(err)) {
+        const result = this.buildInterruptedResult(historyBefore);
+        if (result.response) {
+          this.messages.push((0, import_agent_core3.createAssistantMessage)(result.response));
+        }
+        this.messages.push((0, import_agent_core3.createSystemMessage)("Interrupted by user."));
+        this.emit("interrupted", result);
+      } else {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        this.messages.push((0, import_agent_core3.createSystemMessage)(`Error: ${errMsg}`));
+        this.emit("error", err instanceof Error ? err : new Error(errMsg));
+      }
+    } finally {
+      this.executing = false;
+      this.emit("thinking", false);
+      if (this.pendingPrompt) {
+        const queued = this.pendingPrompt;
+        const queuedDisplay = this.pendingDisplayInput;
+        const queuedRaw = this.pendingRawInput;
+        this.pendingPrompt = null;
+        this.pendingDisplayInput = void 0;
+        this.pendingRawInput = void 0;
+        setTimeout(() => this.executePrompt(queued, queuedDisplay, queuedRaw), 0);
+      }
+    }
+  }
+  // ── Streaming callbacks ───────────────────────────────────────
+  handleTextDelta(delta) {
+    this.streamingText += delta;
+    this.emit("text_delta", delta);
+    if (!this.flushTimer) {
+      this.flushTimer = setTimeout(() => {
+        this.flushTimer = null;
+      }, STREAMING_FLUSH_INTERVAL_MS);
+    }
+  }
+  handleToolExecution(event) {
+    if (event.type === "start") {
+      const firstArg = extractFirstArg(event.toolArgs);
+      const state = {
+        toolName: event.toolName,
+        firstArg,
+        isRunning: true
+      };
+      this.activeTools.push(state);
+      this.emit("tool_start", state);
+    } else {
+      const result = event.denied ? "denied" : event.success === false ? "error" : "success";
+      const idx = this.activeTools.findIndex((t) => t.toolName === event.toolName && t.isRunning);
+      if (idx !== -1) {
+        const finished = {
+          ...this.activeTools[idx],
+          isRunning: false,
+          result
+        };
+        this.activeTools[idx] = finished;
+        this.trimCompletedTools();
+        this.emit("tool_end", finished);
+      }
+    }
+  }
+  // ── Helpers ───────────────────────────────────────────────────
+  clearStreaming() {
+    this.streamingText = "";
+    this.activeTools = [];
+    if (this.flushTimer) {
+      clearTimeout(this.flushTimer);
+      this.flushTimer = null;
+    }
+  }
+  flushStreaming() {
+    if (this.flushTimer) {
+      clearTimeout(this.flushTimer);
+      this.flushTimer = null;
+    }
+  }
+  buildResult(response, historyBefore) {
+    const toolSummaries = this.extractToolSummaries(historyBefore);
+    return {
+      response,
+      messages: this.messages,
+      toolSummaries,
+      contextState: this.getContextState()
+    };
+  }
+  buildInterruptedResult(historyBefore) {
+    const history = this.session.getHistory();
+    const toolSummaries = this.extractToolSummaries(historyBefore);
+    const parts = [];
+    for (let i = historyBefore; i < history.length; i++) {
+      const msg = history[i];
+      if (msg?.role === "assistant" && msg.content) {
+        parts.push(msg.content);
+      }
+    }
+    return {
+      response: parts.join("\n\n"),
+      messages: this.messages,
+      toolSummaries,
+      contextState: this.getContextState()
+    };
+  }
+  extractToolSummaries(historyBefore) {
+    const history = this.session.getHistory();
+    const summaries = [];
+    for (let i = historyBefore; i < history.length; i++) {
+      const msg = history[i];
+      if (msg?.role === "assistant" && msg.toolCalls) {
+        for (const tc of msg.toolCalls) {
+          summaries.push({ name: tc.function.name, args: tc.function.arguments });
+        }
+      }
+    }
+    return summaries;
+  }
+  trimCompletedTools() {
+    const completed = this.activeTools.filter((t) => !t.isRunning);
+    if (completed.length > MAX_COMPLETED_TOOLS) {
+      const excess = completed.length - MAX_COMPLETED_TOOLS;
+      let removed = 0;
+      this.activeTools = this.activeTools.filter((t) => {
+        if (!t.isRunning && removed < excess) {
+          removed++;
+          return false;
+        }
+        return true;
+      });
+    }
+  }
+};
+function isAbortError(err) {
+  return err instanceof DOMException && err.name === "AbortError" || err instanceof Error && (err.message.includes("aborted") || err.message.includes("abort"));
+}
+function extractFirstArg(toolArgs) {
+  if (!toolArgs) return "";
+  const firstVal = Object.values(toolArgs)[0];
+  const raw = typeof firstVal === "string" ? firstVal : JSON.stringify(firstVal ?? "");
+  return raw.length > TOOL_ARG_DISPLAY_MAX ? raw.slice(0, TOOL_ARG_DISPLAY_MAX - TAIL_KEEP - 3) + "..." + raw.slice(-TAIL_KEEP) : raw;
+}
+var NOOP_TERMINAL = {
+  write: () => {
+  },
+  writeLine: () => {
+  },
+  writeMarkdown: () => {
+  },
+  writeError: () => {
+  },
+  prompt: () => Promise.resolve(""),
+  select: () => Promise.resolve(0),
+  spinner: () => ({ stop: () => {
+  }, update: () => {
+  } })
+};
+
 // src/index.ts
 var import_agent_tools3 = require("@robota-sdk/agent-tools");
 var import_agent_tools4 = require("@robota-sdk/agent-tools");
@@ -1979,16 +2683,21 @@ var import_agent_tools8 = require("@robota-sdk/agent-tools");
 0 && (module.exports = {
   AgentExecutor,
   BUILT_IN_AGENTS,
+  BuiltinCommandSource,
   BundlePluginInstaller,
   BundlePluginLoader,
+  CommandRegistry,
   DEFAULT_TOOL_DESCRIPTIONS,
   FileSessionLogger,
+  InteractiveSession,
   MarketplaceClient,
   PluginSettingsStore,
   PromptExecutor,
   Session,
   SessionStore,
   SilentSessionLogger,
+  SkillCommandSource,
+  SystemCommandExecutor,
   TRUST_TO_MODE,
   assembleSubagentPrompt,
   bashTool,
@@ -1999,6 +2708,7 @@ var import_agent_tools8 = require("@robota-sdk/agent-tools");
   createSession,
   createSubagentLogger,
   createSubagentSession,
+  createSystemCommands,
   detectProject,
   editTool,
   evaluatePermission,
@@ -2009,6 +2719,7 @@ var import_agent_tools8 = require("@robota-sdk/agent-tools");
   grepTool,
   loadConfig,
   loadContext,
+  parseFrontmatter,
   projectPaths,
   promptForApproval,
   query,