@robota-sdk/agent-cli 3.0.0-beta.31 → 3.0.0-beta.33

package/README.md

@@ -177,17 +177,17 @@ Configure in `.robota/settings.json` or `.robota/settings.local.json`:
 
 ## Slash Commands
 
-| Command        | Description                     |
-| -------------- | ------------------------------- |
-| `/help`        | Show help                       |
-| `/clear`       | Clear conversation history      |
-| `/mode [mode]` | Show or change permission mode  |
-| `/model [model]`| Select AI model (confirmation + restart) |
-| `/compact [instructions]` | Compress context window  |
-| `/cost`        | Show session info               |
-| `/context`     | Context window details          |
-| `/permissions` | Show permission rules           |
-| `/exit`        | Exit CLI                        |
+| Command                   | Description                              |
+| ------------------------- | ---------------------------------------- |
+| `/help`                   | Show help                                |
+| `/clear`                  | Clear conversation history               |
+| `/mode [mode]`            | Show or change permission mode           |
+| `/model [model]`          | Select AI model (confirmation + restart) |
+| `/compact [instructions]` | Compress context window                  |
+| `/cost`                   | Show session info                        |
+| `/context`                | Context window details                   |
+| `/permissions`            | Show permission rules                    |
+| `/exit`                   | Exit CLI                                 |
 
 ## Configuration
 
@@ -220,6 +220,31 @@ Settings are loaded from (highest priority first):
 
 Copy `.env.example` to `.env` and set your key. The CLI reads `.env` automatically in dev mode.
 
+## Paste Template
+
+When pasting multiline text, the input area collapses it into a label: `[Pasted text #1 +42 lines]`. Multiple pastes are numbered sequentially. The full content is expanded on submit, keeping the input area compact while preserving the complete text for the AI.
+
+## Edit Diff Display
+
+After the Edit tool runs, a `DiffBlock` component renders the change with colored `+`/`-` line markers (green = added, red = removed), giving immediate visual feedback on file modifications.
+
+## Plugin Commands Display
+
+Plugin-provided commands appear in the slash command autocomplete with their source plugin name as a hint. Commands are also accessible via colon format: `/plugin-name:command`.
+
+## Memory Management
+
+The CLI applies two strategies to keep memory usage bounded during long sessions:
+
+- **Message windowing** — Conversation history is capped at 100 messages. Older messages are pruned from the window.
+- **Tool state cleanup** — Completed tool results older than 50 entries are cleaned up to reduce retained state.
+
+React components use `React.memo` to avoid unnecessary re-renders.
+
+### Forced Summary on maxRounds
+
+When the tool execution loop exhausts its maximum rounds, the CLI injects a synthetic user message requesting a summary. This ensures the user always receives a meaningful response even if the agent could not complete all planned tool calls.
+
 ## Context Discovery
 
 The CLI automatically discovers and loads:

package/dist/node/bin.cjs

@@ -27,8 +27,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var import_node_fs3 = require("fs");
 var import_node_path5 = require("path");
 var import_node_url = require("url");
-var import_agent_sdk4 = require("@robota-sdk/agent-sdk");
 var import_agent_sdk5 = require("@robota-sdk/agent-sdk");
+var import_agent_sdk6 = require("@robota-sdk/agent-sdk");
 
 // src/utils/cli-args.ts
 var import_node_util = require("util");
@@ -663,6 +663,7 @@ function useSlashCommands(session, addMessage, setMessages, exit, registry, pend
 
 // src/ui/hooks/useSubmitHandler.ts
 var import_react4 = require("react");
+var import_agent_sdk2 = require("@robota-sdk/agent-sdk");
 
 // src/utils/tool-call-extractor.ts
 var TOOL_ARG_MAX_LENGTH = 80;
@@ -767,6 +768,40 @@ Execute the "${cmd}" skill: ${userInstruction}`;
   return `Use the "${cmd}" skill: ${userInstruction}`;
 }
 
+// src/commands/skill-executor.ts
+function buildProcessedContent(skill, args, context) {
+  if (!skill.skillContent) return null;
+  return substituteVariables(skill.skillContent, args, context);
+}
+function buildInjectPrompt(skill, args, context) {
+  const processed = buildProcessedContent(skill, args, context);
+  if (processed) {
+    const userInstruction = args || skill.description;
+    return `<skill name="${skill.name}">
+${processed}
+</skill>
+
+Execute the "${skill.name}" skill: ${userInstruction}`;
+  }
+  return `Use the "${skill.name}" skill: ${args || skill.description}`;
+}
+async function executeSkill(skill, args, callbacks, context) {
+  if (skill.context === "fork") {
+    if (!callbacks.runInFork) {
+      throw new Error("Fork execution is not available. Agent tool deps may not be initialized.");
+    }
+    const content = buildProcessedContent(skill, args, context);
+    const prompt2 = content ?? `Use the "${skill.name}" skill: ${args || skill.description}`;
+    const options = {};
+    if (skill.agent) options.agent = skill.agent;
+    if (skill.allowedTools) options.allowedTools = skill.allowedTools;
+    const result = await callbacks.runInFork(prompt2, options);
+    return { mode: "fork", result };
+  }
+  const prompt = buildInjectPrompt(skill, args, context);
+  return { mode: "inject", prompt };
+}
+
 // src/ui/hooks/useSubmitHandler.ts
 function syncContextState(session, setter) {
   const ctx = session.getContextState();
@@ -805,6 +840,37 @@ async function runSessionPrompt(prompt, session, addMessage, clearStreamingText,
     setIsThinking(false);
   }
 }
+function createForkRunner(sessionKey) {
+  const deps = (0, import_agent_sdk2.retrieveAgentToolDeps)(sessionKey);
+  if (!deps) return void 0;
+  return async (content, options) => {
+    const agentType = options.agent ?? "general-purpose";
+    const agentDef = (0, import_agent_sdk2.getBuiltInAgent)(agentType) ?? deps.customAgentRegistry?.(agentType);
+    if (!agentDef) {
+      throw new Error(`Unknown agent type for fork execution: ${agentType}`);
+    }
+    const effectiveDef = options.allowedTools ? { ...agentDef, tools: options.allowedTools } : agentDef;
+    const subSession = (0, import_agent_sdk2.createSubagentSession)({
+      agentDefinition: effectiveDef,
+      parentConfig: deps.config,
+      parentContext: deps.context,
+      parentTools: deps.tools,
+      terminal: deps.terminal,
+      isForkWorker: true,
+      permissionHandler: deps.permissionHandler,
+      onTextDelta: deps.onTextDelta,
+      onToolExecution: deps.onToolExecution
+    });
+    return await subSession.run(content);
+  };
+}
+function findSkillCommand(input, registry) {
+  const parts = input.slice(1).split(/\s+/);
+  const cmd = parts[0]?.toLowerCase() ?? "";
+  const skillCmd = registry.getCommands().find((c) => c.name === cmd && (c.source === "skill" || c.source === "plugin"));
+  if (!skillCmd) return null;
+  return { skill: skillCmd, args: parts.slice(1).join(" ").trim() };
+}
 function useSubmitHandler(session, addMessage, handleSlashCommand, clearStreamingText, setIsThinking, setContextState, registry) {
   return (0, import_react4.useCallback)(
     async (input) => {
@@ -814,6 +880,33 @@ function useSubmitHandler(session, addMessage, handleSlashCommand, clearStreamin
           syncContextState(session, setContextState);
           return;
         }
+        const found = findSkillCommand(input, registry);
+        if (!found) return;
+        const { skill, args } = found;
+        if (skill.context === "fork") {
+          const runInFork = createForkRunner(session);
+          const result = await executeSkill(skill, args, { runInFork });
+          if (result.mode === "fork") {
+            addMessage({ role: "assistant", content: result.result ?? "(empty response)" });
+            syncContextState(session, setContextState);
+            return;
+          }
+          if (result.prompt) {
+            const cmdName2 = input.slice(1).split(/\s+/)[0]?.toLowerCase() ?? "";
+            const qualifiedName2 = registry.resolveQualifiedName(cmdName2);
+            const hookInput2 = qualifiedName2 ? `/${qualifiedName2}${input.slice(1 + cmdName2.length)}` : input;
+            return runSessionPrompt(
+              result.prompt,
+              session,
+              addMessage,
+              clearStreamingText,
+              setIsThinking,
+              setContextState,
+              hookInput2
+            );
+          }
+          return;
+        }
         const prompt = await buildSkillPrompt(input, registry);
         if (!prompt) return;
         const cmdName = input.slice(1).split(/\s+/)[0]?.toLowerCase() ?? "";
@@ -855,7 +948,7 @@ function useSubmitHandler(session, addMessage, handleSlashCommand, clearStreamin
 var import_react5 = require("react");
 var import_node_os2 = require("os");
 var import_node_path3 = require("path");
-var import_agent_sdk2 = require("@robota-sdk/agent-sdk");
+var import_agent_sdk3 = require("@robota-sdk/agent-sdk");
 
 // src/commands/command-registry.ts
 var CommandRegistry = class {
@@ -1194,7 +1287,7 @@ function useCommandRegistry(cwd) {
     registry.addSource(new SkillCommandSource(cwd));
     let pluginHooks = {};
     const pluginsDir = (0, import_node_path3.join)((0, import_node_os2.homedir)(), ".robota", "plugins");
-    const loader = new import_agent_sdk2.BundlePluginLoader(pluginsDir);
+    const loader = new import_agent_sdk3.BundlePluginLoader(pluginsDir);
     try {
       const plugins = loader.loadPluginsSync();
       if (plugins.length > 0) {
@@ -1212,20 +1305,20 @@ function useCommandRegistry(cwd) {
 var import_react6 = require("react");
 var import_node_os3 = require("os");
 var import_node_path4 = require("path");
-var import_agent_sdk3 = require("@robota-sdk/agent-sdk");
+var import_agent_sdk4 = require("@robota-sdk/agent-sdk");
 function usePluginCallbacks(cwd) {
   return (0, import_react6.useMemo)(() => {
     const home = (0, import_node_os3.homedir)();
     const pluginsDir = (0, import_node_path4.join)(home, ".robota", "plugins");
     const userSettingsPath = (0, import_node_path4.join)(home, ".robota", "settings.json");
-    const settingsStore = new import_agent_sdk3.PluginSettingsStore(userSettingsPath);
-    const marketplace = new import_agent_sdk3.MarketplaceClient({ pluginsDir });
-    const installer = new import_agent_sdk3.BundlePluginInstaller({
+    const settingsStore = new import_agent_sdk4.PluginSettingsStore(userSettingsPath);
+    const marketplace = new import_agent_sdk4.MarketplaceClient({ pluginsDir });
+    const installer = new import_agent_sdk4.BundlePluginInstaller({
       pluginsDir,
       settingsStore,
       marketplaceClient: marketplace
     });
-    const loader = new import_agent_sdk3.BundlePluginLoader(pluginsDir);
+    const loader = new import_agent_sdk4.BundlePluginLoader(pluginsDir);
     return {
       listInstalled: async () => {
         const plugins = await loader.loadAll();
@@ -1510,6 +1603,7 @@ function CjkTextInput({
   value,
   onChange,
   onSubmit,
+  onPaste,
   placeholder = "",
   focus = true,
   showCursor = true
@@ -1533,6 +1627,10 @@ function CjkTextInput({
           onSubmit?.(valueRef.current);
           return;
         }
+        if (input.length > 1 && (input.includes("\n") || input.includes("\r")) && onPaste) {
+          onPaste(input.replace(/\r\n?/g, "\n"));
+          return;
+        }
         if (key.leftArrow) {
           if (cursorRef.current > 0) {
             cursorRef.current -= 1;
@@ -1655,6 +1753,12 @@ function computeScrollOffset(selectedIndex, total) {
   return Math.min(selectedIndex - MAX_VISIBLE + 1, maxOffset);
 }
 
+// src/utils/paste-labels.ts
+var PASTE_LABEL_RE = /\[Pasted text #(\d+) \+\d+ lines\]/g;
+function expandPasteLabels(text, store) {
+  return text.replace(PASTE_LABEL_RE, (_, id) => store.get(Number(id)) ?? "");
+}
+
 // src/ui/InputArea.tsx
 var import_jsx_runtime7 = require("react/jsx-runtime");
 function parseSlashInput(value) {
@@ -1711,6 +1815,8 @@ function useAutocomplete(value, registry) {
 }
 function InputArea({ onSubmit, isDisabled, registry }) {
   const [value, setValue] = (0, import_react10.useState)("");
+  const pasteStore = (0, import_react10.useRef)(/* @__PURE__ */ new Map());
+  const pasteIdRef = (0, import_react10.useRef)(0);
   const {
     showPopup,
     filteredCommands,
@@ -1719,6 +1825,14 @@ function InputArea({ onSubmit, isDisabled, registry }) {
     isSubcommandMode,
     setShowPopup
   } = useAutocomplete(value, registry);
+  const handlePaste = (0, import_react10.useCallback)((text) => {
+    pasteIdRef.current += 1;
+    const id = pasteIdRef.current;
+    pasteStore.current.set(id, text);
+    const lineCount = text.split("\n").length;
+    const label = `[Pasted text #${id} +${lineCount} lines]`;
+    setValue((prev) => prev ? `${prev} ${label}` : label);
+  }, []);
   const handleSubmit = (0, import_react10.useCallback)(
     (text) => {
       const trimmed = text.trim();
@@ -1727,8 +1841,11 @@ function InputArea({ onSubmit, isDisabled, registry }) {
         selectCommand(filteredCommands[selectedIndex]);
         return;
       }
+      const expanded = expandPasteLabels(trimmed, pasteStore.current);
       setValue("");
-      onSubmit(trimmed);
+      pasteStore.current.clear();
+      pasteIdRef.current = 0;
+      onSubmit(expanded);
     },
     [showPopup, filteredCommands, selectedIndex, onSubmit]
   );
@@ -1785,6 +1902,7 @@ function InputArea({ onSubmit, isDisabled, registry }) {
           value,
           onChange: setValue,
           onSubmit: handleSubmit,
+          onPaste: handlePaste,
           placeholder: "Type a message or /help"
         }
       )
@@ -2257,9 +2375,9 @@ async function startCli() {
   const cwd = process.cwd();
   await ensureConfig(cwd);
   const [config, context, projectInfo] = await Promise.all([
-    (0, import_agent_sdk4.loadConfig)(cwd),
-    (0, import_agent_sdk4.loadContext)(cwd),
-    (0, import_agent_sdk4.detectProject)(cwd)
+    (0, import_agent_sdk5.loadConfig)(cwd),
+    (0, import_agent_sdk5.loadContext)(cwd),
+    (0, import_agent_sdk5.detectProject)(cwd)
   ]);
   if (args.model !== void 0) {
     config.provider.model = args.model;
@@ -2267,7 +2385,7 @@ async function startCli() {
   if (args.language !== void 0) {
     config.language = args.language;
   }
-  const sessionStore = new import_agent_sdk4.SessionStore();
+  const sessionStore = new import_agent_sdk5.SessionStore();
   if (args.printMode) {
     const prompt = args.positional.join(" ").trim();
     if (prompt.length === 0) {
@@ -2275,15 +2393,15 @@ async function startCli() {
       process.exit(1);
     }
     const terminal = new PrintTerminal();
-    const paths = (0, import_agent_sdk4.projectPaths)(cwd);
-    const session = (0, import_agent_sdk4.createSession)({
+    const paths = (0, import_agent_sdk5.projectPaths)(cwd);
+    const session = (0, import_agent_sdk5.createSession)({
       config,
       context,
       terminal,
-      sessionLogger: new import_agent_sdk4.FileSessionLogger(paths.logs),
+      sessionLogger: new import_agent_sdk5.FileSessionLogger(paths.logs),
       projectInfo,
       permissionMode: args.permissionMode,
-      promptForApproval: import_agent_sdk5.promptForApproval
+      promptForApproval: import_agent_sdk6.promptForApproval
     });
     const response = await session.run(prompt);
     process.stdout.write(response + "\n");

package/dist/node/bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   startCli
-} from "./chunk-2CGAQADC.js";
+} from "./chunk-EPCRZIQ6.js";
 
 // src/bin.ts
 process.on("uncaughtException", (err) => {

package/dist/node/{chunk-2CGAQADC.js → chunk-EPCRZIQ6.js}

@@ -149,7 +149,7 @@ var PrintTerminal = class {
 import { render } from "ink";
 
 // src/ui/App.tsx
-import { useState as useState7, useRef as useRef5 } from "react";
+import { useState as useState7, useRef as useRef6 } from "react";
 import { Box as Box9, Text as Text11, useApp, useInput as useInput5 } from "ink";
 import { getModelName } from "@robota-sdk/agent-core";
 
@@ -646,6 +646,11 @@ function useSlashCommands(session, addMessage, setMessages, exit, registry, pend
 
 // src/ui/hooks/useSubmitHandler.ts
 import { useCallback as useCallback4 } from "react";
+import {
+  createSubagentSession,
+  getBuiltInAgent,
+  retrieveAgentToolDeps
+} from "@robota-sdk/agent-sdk";
 
 // src/utils/tool-call-extractor.ts
 var TOOL_ARG_MAX_LENGTH = 80;
@@ -750,6 +755,40 @@ Execute the "${cmd}" skill: ${userInstruction}`;
   return `Use the "${cmd}" skill: ${userInstruction}`;
 }
 
+// src/commands/skill-executor.ts
+function buildProcessedContent(skill, args, context) {
+  if (!skill.skillContent) return null;
+  return substituteVariables(skill.skillContent, args, context);
+}
+function buildInjectPrompt(skill, args, context) {
+  const processed = buildProcessedContent(skill, args, context);
+  if (processed) {
+    const userInstruction = args || skill.description;
+    return `<skill name="${skill.name}">
+${processed}
+</skill>
+
+Execute the "${skill.name}" skill: ${userInstruction}`;
+  }
+  return `Use the "${skill.name}" skill: ${args || skill.description}`;
+}
+async function executeSkill(skill, args, callbacks, context) {
+  if (skill.context === "fork") {
+    if (!callbacks.runInFork) {
+      throw new Error("Fork execution is not available. Agent tool deps may not be initialized.");
+    }
+    const content = buildProcessedContent(skill, args, context);
+    const prompt2 = content ?? `Use the "${skill.name}" skill: ${args || skill.description}`;
+    const options = {};
+    if (skill.agent) options.agent = skill.agent;
+    if (skill.allowedTools) options.allowedTools = skill.allowedTools;
+    const result = await callbacks.runInFork(prompt2, options);
+    return { mode: "fork", result };
+  }
+  const prompt = buildInjectPrompt(skill, args, context);
+  return { mode: "inject", prompt };
+}
+
 // src/ui/hooks/useSubmitHandler.ts
 function syncContextState(session, setter) {
   const ctx = session.getContextState();
@@ -788,6 +827,37 @@ async function runSessionPrompt(prompt, session, addMessage, clearStreamingText,
     setIsThinking(false);
   }
 }
+function createForkRunner(sessionKey) {
+  const deps = retrieveAgentToolDeps(sessionKey);
+  if (!deps) return void 0;
+  return async (content, options) => {
+    const agentType = options.agent ?? "general-purpose";
+    const agentDef = getBuiltInAgent(agentType) ?? deps.customAgentRegistry?.(agentType);
+    if (!agentDef) {
+      throw new Error(`Unknown agent type for fork execution: ${agentType}`);
+    }
+    const effectiveDef = options.allowedTools ? { ...agentDef, tools: options.allowedTools } : agentDef;
+    const subSession = createSubagentSession({
+      agentDefinition: effectiveDef,
+      parentConfig: deps.config,
+      parentContext: deps.context,
+      parentTools: deps.tools,
+      terminal: deps.terminal,
+      isForkWorker: true,
+      permissionHandler: deps.permissionHandler,
+      onTextDelta: deps.onTextDelta,
+      onToolExecution: deps.onToolExecution
+    });
+    return await subSession.run(content);
+  };
+}
+function findSkillCommand(input, registry) {
+  const parts = input.slice(1).split(/\s+/);
+  const cmd = parts[0]?.toLowerCase() ?? "";
+  const skillCmd = registry.getCommands().find((c) => c.name === cmd && (c.source === "skill" || c.source === "plugin"));
+  if (!skillCmd) return null;
+  return { skill: skillCmd, args: parts.slice(1).join(" ").trim() };
+}
 function useSubmitHandler(session, addMessage, handleSlashCommand, clearStreamingText, setIsThinking, setContextState, registry) {
   return useCallback4(
     async (input) => {
@@ -797,6 +867,33 @@ function useSubmitHandler(session, addMessage, handleSlashCommand, clearStreamin
           syncContextState(session, setContextState);
           return;
         }
+        const found = findSkillCommand(input, registry);
+        if (!found) return;
+        const { skill, args } = found;
+        if (skill.context === "fork") {
+          const runInFork = createForkRunner(session);
+          const result = await executeSkill(skill, args, { runInFork });
+          if (result.mode === "fork") {
+            addMessage({ role: "assistant", content: result.result ?? "(empty response)" });
+            syncContextState(session, setContextState);
+            return;
+          }
+          if (result.prompt) {
+            const cmdName2 = input.slice(1).split(/\s+/)[0]?.toLowerCase() ?? "";
+            const qualifiedName2 = registry.resolveQualifiedName(cmdName2);
+            const hookInput2 = qualifiedName2 ? `/${qualifiedName2}${input.slice(1 + cmdName2.length)}` : input;
+            return runSessionPrompt(
+              result.prompt,
+              session,
+              addMessage,
+              clearStreamingText,
+              setIsThinking,
+              setContextState,
+              hookInput2
+            );
+          }
+          return;
+        }
         const prompt = await buildSkillPrompt(input, registry);
         if (!prompt) return;
         const cmdName = input.slice(1).split(/\s+/)[0]?.toLowerCase() ?? "";
@@ -1478,7 +1575,7 @@ function StatusBar({
 }
 
 // src/ui/InputArea.tsx
-import React5, { useState as useState5, useCallback as useCallback5, useMemo as useMemo2 } from "react";
+import React5, { useState as useState5, useCallback as useCallback5, useMemo as useMemo2, useRef as useRef4 } from "react";
 import { Box as Box5, Text as Text7, useInput as useInput2 } from "ink";
 
 // src/ui/CjkTextInput.tsx
@@ -1498,6 +1595,7 @@ function CjkTextInput({
   value,
   onChange,
   onSubmit,
+  onPaste,
   placeholder = "",
   focus = true,
   showCursor = true
@@ -1521,6 +1619,10 @@ function CjkTextInput({
           onSubmit?.(valueRef.current);
           return;
         }
+        if (input.length > 1 && (input.includes("\n") || input.includes("\r")) && onPaste) {
+          onPaste(input.replace(/\r\n?/g, "\n"));
+          return;
+        }
         if (key.leftArrow) {
           if (cursorRef.current > 0) {
             cursorRef.current -= 1;
@@ -1643,6 +1745,12 @@ function computeScrollOffset(selectedIndex, total) {
   return Math.min(selectedIndex - MAX_VISIBLE + 1, maxOffset);
 }
 
+// src/utils/paste-labels.ts
+var PASTE_LABEL_RE = /\[Pasted text #(\d+) \+\d+ lines\]/g;
+function expandPasteLabels(text, store) {
+  return text.replace(PASTE_LABEL_RE, (_, id) => store.get(Number(id)) ?? "");
+}
+
 // src/ui/InputArea.tsx
 import { jsx as jsx6, jsxs as jsxs5 } from "react/jsx-runtime";
 function parseSlashInput(value) {
@@ -1699,6 +1807,8 @@ function useAutocomplete(value, registry) {
 }
 function InputArea({ onSubmit, isDisabled, registry }) {
   const [value, setValue] = useState5("");
+  const pasteStore = useRef4(/* @__PURE__ */ new Map());
+  const pasteIdRef = useRef4(0);
   const {
     showPopup,
     filteredCommands,
@@ -1707,6 +1817,14 @@ function InputArea({ onSubmit, isDisabled, registry }) {
     isSubcommandMode,
     setShowPopup
   } = useAutocomplete(value, registry);
+  const handlePaste = useCallback5((text) => {
+    pasteIdRef.current += 1;
+    const id = pasteIdRef.current;
+    pasteStore.current.set(id, text);
+    const lineCount = text.split("\n").length;
+    const label = `[Pasted text #${id} +${lineCount} lines]`;
+    setValue((prev) => prev ? `${prev} ${label}` : label);
+  }, []);
   const handleSubmit = useCallback5(
     (text) => {
       const trimmed = text.trim();
@@ -1715,8 +1833,11 @@ function InputArea({ onSubmit, isDisabled, registry }) {
         selectCommand(filteredCommands[selectedIndex]);
         return;
       }
+      const expanded = expandPasteLabels(trimmed, pasteStore.current);
       setValue("");
-      onSubmit(trimmed);
+      pasteStore.current.clear();
+      pasteIdRef.current = 0;
+      onSubmit(expanded);
     },
     [showPopup, filteredCommands, selectedIndex, onSubmit]
   );
@@ -1773,6 +1894,7 @@ function InputArea({ onSubmit, isDisabled, registry }) {
           value,
           onChange: setValue,
           onSubmit: handleSubmit,
+          onPaste: handlePaste,
           placeholder: "Type a message or /help"
         }
       )
@@ -1781,7 +1903,7 @@ function InputArea({ onSubmit, isDisabled, registry }) {
 }
 
 // src/ui/ConfirmPrompt.tsx
-import { useState as useState6, useCallback as useCallback6, useRef as useRef4 } from "react";
+import { useState as useState6, useCallback as useCallback6, useRef as useRef5 } from "react";
 import { Box as Box6, Text as Text8, useInput as useInput3 } from "ink";
 import { jsx as jsx7, jsxs as jsxs6 } from "react/jsx-runtime";
 function ConfirmPrompt({
@@ -1790,7 +1912,7 @@ function ConfirmPrompt({
   onSelect
 }) {
   const [selected, setSelected] = useState6(0);
-  const resolvedRef = useRef4(false);
+  const resolvedRef = useRef5(false);
   const doSelect = useCallback6(
     (index) => {
       if (resolvedRef.current) return;
@@ -1970,7 +2092,7 @@ function App(props) {
     usedTokens: initialCtx.usedTokens,
     maxTokens: initialCtx.maxTokens
   });
-  const pendingModelChangeRef = useRef5(null);
+  const pendingModelChangeRef = useRef6(null);
   const [pendingModelId, setPendingModelId] = useState7(null);
   const pluginCallbacks = usePluginCallbacks(props.cwd ?? process.cwd());
   const handleSlashCommand = useSlashCommands(

package/dist/node/index.cjs

@@ -30,21 +30,21 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  Session: () => import_agent_sdk6.Session,
-  SessionStore: () => import_agent_sdk6.SessionStore,
-  TRUST_TO_MODE: () => import_agent_sdk6.TRUST_TO_MODE,
-  query: () => import_agent_sdk6.query,
+  Session: () => import_agent_sdk7.Session,
+  SessionStore: () => import_agent_sdk7.SessionStore,
+  TRUST_TO_MODE: () => import_agent_sdk7.TRUST_TO_MODE,
+  query: () => import_agent_sdk7.query,
   startCli: () => startCli
 });
 module.exports = __toCommonJS(index_exports);
-var import_agent_sdk6 = require("@robota-sdk/agent-sdk");
+var import_agent_sdk7 = require("@robota-sdk/agent-sdk");
 
 // src/cli.ts
 var import_node_fs3 = require("fs");
 var import_node_path5 = require("path");
 var import_node_url = require("url");
-var import_agent_sdk4 = require("@robota-sdk/agent-sdk");
 var import_agent_sdk5 = require("@robota-sdk/agent-sdk");
+var import_agent_sdk6 = require("@robota-sdk/agent-sdk");
 
 // src/utils/cli-args.ts
 var import_node_util = require("util");
@@ -679,6 +679,7 @@ function useSlashCommands(session, addMessage, setMessages, exit, registry, pend
 
 // src/ui/hooks/useSubmitHandler.ts
 var import_react4 = require("react");
+var import_agent_sdk2 = require("@robota-sdk/agent-sdk");
 
 // src/utils/tool-call-extractor.ts
 var TOOL_ARG_MAX_LENGTH = 80;
@@ -783,6 +784,40 @@ Execute the "${cmd}" skill: ${userInstruction}`;
   return `Use the "${cmd}" skill: ${userInstruction}`;
 }
 
+// src/commands/skill-executor.ts
+function buildProcessedContent(skill, args, context) {
+  if (!skill.skillContent) return null;
+  return substituteVariables(skill.skillContent, args, context);
+}
+function buildInjectPrompt(skill, args, context) {
+  const processed = buildProcessedContent(skill, args, context);
+  if (processed) {
+    const userInstruction = args || skill.description;
+    return `<skill name="${skill.name}">
+${processed}
+</skill>
+
+Execute the "${skill.name}" skill: ${userInstruction}`;
+  }
+  return `Use the "${skill.name}" skill: ${args || skill.description}`;
+}
+async function executeSkill(skill, args, callbacks, context) {
+  if (skill.context === "fork") {
+    if (!callbacks.runInFork) {
+      throw new Error("Fork execution is not available. Agent tool deps may not be initialized.");
+    }
+    const content = buildProcessedContent(skill, args, context);
+    const prompt2 = content ?? `Use the "${skill.name}" skill: ${args || skill.description}`;
+    const options = {};
+    if (skill.agent) options.agent = skill.agent;
+    if (skill.allowedTools) options.allowedTools = skill.allowedTools;
+    const result = await callbacks.runInFork(prompt2, options);
+    return { mode: "fork", result };
+  }
+  const prompt = buildInjectPrompt(skill, args, context);
+  return { mode: "inject", prompt };
+}
+
 // src/ui/hooks/useSubmitHandler.ts
 function syncContextState(session, setter) {
   const ctx = session.getContextState();
@@ -821,6 +856,37 @@ async function runSessionPrompt(prompt, session, addMessage, clearStreamingText,
     setIsThinking(false);
   }
 }
+function createForkRunner(sessionKey) {
+  const deps = (0, import_agent_sdk2.retrieveAgentToolDeps)(sessionKey);
+  if (!deps) return void 0;
+  return async (content, options) => {
+    const agentType = options.agent ?? "general-purpose";
+    const agentDef = (0, import_agent_sdk2.getBuiltInAgent)(agentType) ?? deps.customAgentRegistry?.(agentType);
+    if (!agentDef) {
+      throw new Error(`Unknown agent type for fork execution: ${agentType}`);
+    }
+    const effectiveDef = options.allowedTools ? { ...agentDef, tools: options.allowedTools } : agentDef;
+    const subSession = (0, import_agent_sdk2.createSubagentSession)({
+      agentDefinition: effectiveDef,
+      parentConfig: deps.config,
+      parentContext: deps.context,
+      parentTools: deps.tools,
+      terminal: deps.terminal,
+      isForkWorker: true,
+      permissionHandler: deps.permissionHandler,
+      onTextDelta: deps.onTextDelta,
+      onToolExecution: deps.onToolExecution
+    });
+    return await subSession.run(content);
+  };
+}
+function findSkillCommand(input, registry) {
+  const parts = input.slice(1).split(/\s+/);
+  const cmd = parts[0]?.toLowerCase() ?? "";
+  const skillCmd = registry.getCommands().find((c) => c.name === cmd && (c.source === "skill" || c.source === "plugin"));
+  if (!skillCmd) return null;
+  return { skill: skillCmd, args: parts.slice(1).join(" ").trim() };
+}
 function useSubmitHandler(session, addMessage, handleSlashCommand, clearStreamingText, setIsThinking, setContextState, registry) {
   return (0, import_react4.useCallback)(
     async (input) => {
@@ -830,6 +896,33 @@ function useSubmitHandler(session, addMessage, handleSlashCommand, clearStreamin
           syncContextState(session, setContextState);
           return;
         }
+        const found = findSkillCommand(input, registry);
+        if (!found) return;
+        const { skill, args } = found;
+        if (skill.context === "fork") {
+          const runInFork = createForkRunner(session);
+          const result = await executeSkill(skill, args, { runInFork });
+          if (result.mode === "fork") {
+            addMessage({ role: "assistant", content: result.result ?? "(empty response)" });
+            syncContextState(session, setContextState);
+            return;
+          }
+          if (result.prompt) {
+            const cmdName2 = input.slice(1).split(/\s+/)[0]?.toLowerCase() ?? "";
+            const qualifiedName2 = registry.resolveQualifiedName(cmdName2);
+            const hookInput2 = qualifiedName2 ? `/${qualifiedName2}${input.slice(1 + cmdName2.length)}` : input;
+            return runSessionPrompt(
+              result.prompt,
+              session,
+              addMessage,
+              clearStreamingText,
+              setIsThinking,
+              setContextState,
+              hookInput2
+            );
+          }
+          return;
+        }
         const prompt = await buildSkillPrompt(input, registry);
         if (!prompt) return;
         const cmdName = input.slice(1).split(/\s+/)[0]?.toLowerCase() ?? "";
@@ -871,7 +964,7 @@ function useSubmitHandler(session, addMessage, handleSlashCommand, clearStreamin
 var import_react5 = require("react");
 var import_node_os2 = require("os");
 var import_node_path3 = require("path");
-var import_agent_sdk2 = require("@robota-sdk/agent-sdk");
+var import_agent_sdk3 = require("@robota-sdk/agent-sdk");
 
 // src/commands/command-registry.ts
 var CommandRegistry = class {
@@ -1210,7 +1303,7 @@ function useCommandRegistry(cwd) {
     registry.addSource(new SkillCommandSource(cwd));
     let pluginHooks = {};
     const pluginsDir = (0, import_node_path3.join)((0, import_node_os2.homedir)(), ".robota", "plugins");
-    const loader = new import_agent_sdk2.BundlePluginLoader(pluginsDir);
+    const loader = new import_agent_sdk3.BundlePluginLoader(pluginsDir);
     try {
       const plugins = loader.loadPluginsSync();
       if (plugins.length > 0) {
@@ -1228,20 +1321,20 @@ function useCommandRegistry(cwd) {
 var import_react6 = require("react");
 var import_node_os3 = require("os");
 var import_node_path4 = require("path");
-var import_agent_sdk3 = require("@robota-sdk/agent-sdk");
+var import_agent_sdk4 = require("@robota-sdk/agent-sdk");
 function usePluginCallbacks(cwd) {
   return (0, import_react6.useMemo)(() => {
     const home = (0, import_node_os3.homedir)();
     const pluginsDir = (0, import_node_path4.join)(home, ".robota", "plugins");
     const userSettingsPath = (0, import_node_path4.join)(home, ".robota", "settings.json");
-    const settingsStore = new import_agent_sdk3.PluginSettingsStore(userSettingsPath);
-    const marketplace = new import_agent_sdk3.MarketplaceClient({ pluginsDir });
-    const installer = new import_agent_sdk3.BundlePluginInstaller({
+    const settingsStore = new import_agent_sdk4.PluginSettingsStore(userSettingsPath);
+    const marketplace = new import_agent_sdk4.MarketplaceClient({ pluginsDir });
+    const installer = new import_agent_sdk4.BundlePluginInstaller({
       pluginsDir,
       settingsStore,
       marketplaceClient: marketplace
     });
-    const loader = new import_agent_sdk3.BundlePluginLoader(pluginsDir);
+    const loader = new import_agent_sdk4.BundlePluginLoader(pluginsDir);
     return {
       listInstalled: async () => {
         const plugins = await loader.loadAll();
@@ -1526,6 +1619,7 @@ function CjkTextInput({
   value,
   onChange,
   onSubmit,
+  onPaste,
   placeholder = "",
   focus = true,
   showCursor = true
@@ -1549,6 +1643,10 @@ function CjkTextInput({
           onSubmit?.(valueRef.current);
           return;
         }
+        if (input.length > 1 && (input.includes("\n") || input.includes("\r")) && onPaste) {
+          onPaste(input.replace(/\r\n?/g, "\n"));
+          return;
+        }
         if (key.leftArrow) {
           if (cursorRef.current > 0) {
             cursorRef.current -= 1;
@@ -1671,6 +1769,12 @@ function computeScrollOffset(selectedIndex, total) {
   return Math.min(selectedIndex - MAX_VISIBLE + 1, maxOffset);
 }
 
+// src/utils/paste-labels.ts
+var PASTE_LABEL_RE = /\[Pasted text #(\d+) \+\d+ lines\]/g;
+function expandPasteLabels(text, store) {
+  return text.replace(PASTE_LABEL_RE, (_, id) => store.get(Number(id)) ?? "");
+}
+
 // src/ui/InputArea.tsx
 var import_jsx_runtime7 = require("react/jsx-runtime");
 function parseSlashInput(value) {
@@ -1727,6 +1831,8 @@ function useAutocomplete(value, registry) {
 }
 function InputArea({ onSubmit, isDisabled, registry }) {
   const [value, setValue] = (0, import_react10.useState)("");
+  const pasteStore = (0, import_react10.useRef)(/* @__PURE__ */ new Map());
+  const pasteIdRef = (0, import_react10.useRef)(0);
   const {
     showPopup,
     filteredCommands,
@@ -1735,6 +1841,14 @@ function InputArea({ onSubmit, isDisabled, registry }) {
     isSubcommandMode,
     setShowPopup
   } = useAutocomplete(value, registry);
+  const handlePaste = (0, import_react10.useCallback)((text) => {
+    pasteIdRef.current += 1;
+    const id = pasteIdRef.current;
+    pasteStore.current.set(id, text);
+    const lineCount = text.split("\n").length;
+    const label = `[Pasted text #${id} +${lineCount} lines]`;
+    setValue((prev) => prev ? `${prev} ${label}` : label);
+  }, []);
   const handleSubmit = (0, import_react10.useCallback)(
     (text) => {
       const trimmed = text.trim();
@@ -1743,8 +1857,11 @@ function InputArea({ onSubmit, isDisabled, registry }) {
         selectCommand(filteredCommands[selectedIndex]);
         return;
       }
+      const expanded = expandPasteLabels(trimmed, pasteStore.current);
       setValue("");
-      onSubmit(trimmed);
+      pasteStore.current.clear();
+      pasteIdRef.current = 0;
+      onSubmit(expanded);
     },
     [showPopup, filteredCommands, selectedIndex, onSubmit]
   );
@@ -1801,6 +1918,7 @@ function InputArea({ onSubmit, isDisabled, registry }) {
           value,
           onChange: setValue,
           onSubmit: handleSubmit,
+          onPaste: handlePaste,
           placeholder: "Type a message or /help"
         }
       )
@@ -2273,9 +2391,9 @@ async function startCli() {
   const cwd = process.cwd();
   await ensureConfig(cwd);
   const [config, context, projectInfo] = await Promise.all([
-    (0, import_agent_sdk4.loadConfig)(cwd),
-    (0, import_agent_sdk4.loadContext)(cwd),
-    (0, import_agent_sdk4.detectProject)(cwd)
+    (0, import_agent_sdk5.loadConfig)(cwd),
+    (0, import_agent_sdk5.loadContext)(cwd),
+    (0, import_agent_sdk5.detectProject)(cwd)
   ]);
   if (args.model !== void 0) {
     config.provider.model = args.model;
@@ -2283,7 +2401,7 @@ async function startCli() {
   if (args.language !== void 0) {
     config.language = args.language;
   }
-  const sessionStore = new import_agent_sdk4.SessionStore();
+  const sessionStore = new import_agent_sdk5.SessionStore();
   if (args.printMode) {
     const prompt = args.positional.join(" ").trim();
     if (prompt.length === 0) {
@@ -2291,15 +2409,15 @@ async function startCli() {
       process.exit(1);
     }
     const terminal = new PrintTerminal();
-    const paths = (0, import_agent_sdk4.projectPaths)(cwd);
-    const session = (0, import_agent_sdk4.createSession)({
+    const paths = (0, import_agent_sdk5.projectPaths)(cwd);
+    const session = (0, import_agent_sdk5.createSession)({
       config,
       context,
       terminal,
-      sessionLogger: new import_agent_sdk4.FileSessionLogger(paths.logs),
+      sessionLogger: new import_agent_sdk5.FileSessionLogger(paths.logs),
       projectInfo,
       permissionMode: args.permissionMode,
-      promptForApproval: import_agent_sdk5.promptForApproval
+      promptForApproval: import_agent_sdk6.promptForApproval
     });
     const response = await session.run(prompt);
     process.stdout.write(response + "\n");

package/dist/node/index.js

@@ -1,6 +1,6 @@
 import {
   startCli
-} from "./chunk-2CGAQADC.js";
+} from "./chunk-EPCRZIQ6.js";
 
 // src/index.ts
 import { Session, SessionStore, query, TRUST_TO_MODE } from "@robota-sdk/agent-sdk";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robota-sdk/agent-cli",
-  "version": "3.0.0-beta.31",
+  "version": "3.0.0-beta.33",
   "description": "AI coding assistant CLI built on Robota SDK",
   "type": "module",
   "bin": {
@@ -35,8 +35,8 @@
     "marked-terminal": "^7.3.0",
     "react": "19.2.4",
     "string-width": "^8.2.0",
-    "@robota-sdk/agent-core": "3.0.0-beta.31",
-    "@robota-sdk/agent-sdk": "3.0.0-beta.31"
+    "@robota-sdk/agent-core": "3.0.0-beta.33",
+    "@robota-sdk/agent-sdk": "3.0.0-beta.33"
   },
   "devDependencies": {
     "@types/marked": "^6.0.0",