@robota-sdk/agent-transport 3.0.0-beta.64 → 3.0.0-beta.65

package/dist/node/ws/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../ws-COnIgnmn.cjs`);exports.WsTransport=e.t,exports.createWsHandler=e.r,exports.createWsTransport=e.n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../ws-XRTSFZOK.cjs`);exports.WsTransport=e.t,exports.createWsHandler=e.r,exports.createWsTransport=e.n;

package/dist/node/{ws-COnIgnmn.cjs → ws-XRTSFZOK.cjs}

@@ -1 +1 @@
-require(`./tui-CeD_6rSo.cjs`);let e=require(`node:http`),t=require(`ws`);function n(e,t,n){if(n.type===`get-background-tasks`){t({type:`background_tasks`,tasks:e.listBackgroundTasks(n.filter)});return}if(n.type===`get-background-task`){i(e,t,n);return}if(n.type===`get-background-job-groups`){t({type:`background_job_groups`,groups:e.listBackgroundJobGroups()});return}if(n.type===`get-background-job-group`){o(e,t,n);return}if(n.type===`wait-background-job-group`){s(e,t,n);return}a(e,t,n)}function r(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}if(n.type===`cancel-background-task`){l(t,`cancel`,n.taskId,e.cancelBackgroundTask(n.taskId,n.reason));return}if(n.type===`close-background-task`){l(t,`close`,n.taskId,e.closeBackgroundTask(n.taskId));return}c(e,t,n)}function i(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}t({type:`background_task`,taskId:n.taskId,task:e.getBackgroundTask(n.taskId)??null})}function a(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}e.readBackgroundTaskLog(n.taskId,n.cursor).then(e=>t({type:`background_task_log`,taskId:n.taskId,page:e}),e=>t({type:`protocol_error`,message:e.message}))}function o(e,t,n){if(!n.groupId){t({type:`protocol_error`,message:`groupId is required`});return}t({type:`background_job_group`,groupId:n.groupId,group:e.getBackgroundJobGroup(n.groupId)??null})}function s(e,t,n){if(!n.groupId){t({type:`protocol_error`,message:`groupId is required`});return}e.waitBackgroundJobGroup(n.groupId).then(e=>t({type:`background_job_group`,groupId:n.groupId,group:e}),e=>t({type:`protocol_error`,message:e.message}))}function c(e,t,n){if(!n.input){t({type:`protocol_error`,message:`input is required`});return}l(t,`send`,n.taskId,e.sendBackgroundTask(n.taskId,n.input))}function l(e,t,n,r){r.then(()=>e({type:`background_task_control_result`,action:t,taskId:n,success:!0}),r=>e({type:`background_task_control_result`,action:t,taskId:n,success:!1,message:r.message}))}function u(e){let t=d(e.session,e.send);return{onMessage:f(e.session,e.send),cleanup:t}}function d(e,t){let n=e=>t({type:`user_message`,content:e}),r=e=>t({type:`text_delta`,delta:e}),i=e=>t({type:`tool_start`,state:e}),a=e=>t({type:`tool_end`,state:e}),o=e=>t({type:`thinking`,isThinking:e}),s=e=>t({type:`complete`,result:e}),c=e=>t({type:`interrupted`,result:e}),l=e=>t({type:`error`,message:e.message}),u=e=>t({type:`background_task_event`,event:e}),d=e=>t({type:`background_job_group_event`,event:e}),f=e=>t({type:`execution_workspace_event`,snapshot:e.snapshot});return e.on(`user_message`,n),e.on(`text_delta`,r),e.on(`tool_start`,i),e.on(`tool_end`,a),e.on(`thinking`,o),e.on(`complete`,s),e.on(`interrupted`,c),e.on(`error`,l),e.on(`background_task_event`,u),e.on(`background_job_group_event`,d),e.on(`execution_workspace_event`,f),()=>{e.off(`user_message`,n),e.off(`text_delta`,r),e.off(`tool_start`,i),e.off(`tool_end`,a),e.off(`thinking`,o),e.off(`complete`,s),e.off(`interrupted`,c),e.off(`error`,l),e.off(`background_task_event`,u),e.off(`background_job_group_event`,d),e.off(`execution_workspace_event`,f)}}function f(e,t){return n=>{let r=p(n,t);r&&m(e,t,r)}}function p(e,t){try{return JSON.parse(e)}catch{return t({type:`protocol_error`,message:`Invalid JSON`}),null}}function m(e,t,i){if(g(i)){b(e,t,i);return}if(_(i)){x(e,t,i);return}if(v(i)){n(e,t,i);return}if(y(i)){r(e,t,i);return}t({type:`protocol_error`,message:`Unknown message type: ${h(i)}`})}function h(e){return e.type}function g(e){return e.type===`submit`||e.type===`command`||e.type===`abort`||e.type===`cancel-queue`}function _(e){return e.type===`get-messages`||e.type===`get-context`||e.type===`get-executing`||e.type===`get-pending`||e.type===`get-execution-workspace`}function v(e){return e.type===`get-background-tasks`||e.type===`get-background-task`||e.type===`read-background-task-log`||e.type===`get-background-job-groups`||e.type===`get-background-job-group`||e.type===`wait-background-job-group`}function y(e){return e.type===`cancel-background-task`||e.type===`close-background-task`||e.type===`send-background-task`}function b(e,t,n){if(n.type===`submit`){if(!n.prompt){t({type:`protocol_error`,message:`prompt is required`});return}e.submit(n.prompt)}else if(n.type===`command`){if(!n.name){t({type:`protocol_error`,message:`name is required`});return}e.executeCommand(n.name,n.args??``).then(e=>{t({type:`command_result`,name:n.name,message:e?.message??`Unknown command: ${n.name}`,success:e?.success??!1,data:e?.data})})}else n.type===`abort`?e.abort():e.cancelQueue()}function x(e,t,n){n.type===`get-messages`?t({type:`messages`,messages:e.getMessages()}):n.type===`get-context`?t({type:`context`,state:e.getContextState()}):n.type===`get-executing`?t({type:`executing`,executing:e.isExecuting()}):n.type===`get-execution-workspace`?t({type:`execution_workspace_event`,snapshot:e.getExecutionWorkspaceSnapshot()}):t({type:`pending`,pending:e.getPendingPrompt()})}function S(e){let t=null,n=null;return{name:`ws`,onMessage:null,attach(e){t=e},async start(){if(!t)throw Error(`No session attached. Call attach() first.`);let r=u({session:t,send:e.send});n=r.cleanup,this.onMessage=r.onMessage},async stop(){n?.(),n=null,this.onMessage=null}}}const C=7070;var w=class{name=`ws`;defaultEnabled=!0;optionsSchema={port:{type:`number`,description:`WebSocket server port`,default:C},maxRetries:{type:`number`,description:`Port retry attempts when port is occupied`,default:20}};session=null;stopFn=null;port;maxRetries;constructor(e={}){this.port=e.port??C,this.maxRetries=e.maxRetries??20}attach(e){this.session=e}async start(){if(!this.session)throw Error(`WsTransport: attach() must be called before start()`);let e=await this.bindWithRetry(this.session,this.port,this.maxRetries);this.stopFn=e.stop}async stop(){await this.stopFn?.(),this.stopFn=null}validateOptions(e){let{port:t,maxRetries:n}=e;return!(t!==void 0&&(typeof t!=`number`||t<1||t>65535)||n!==void 0&&(typeof n!=`number`||n<0))}bindWithRetry(e,t,n){return this.tryBind(e,t).catch(r=>{if(r.code===`EADDRINUSE`&&n>0)return this.bindWithRetry(e,t+1,n-1);throw r})}tryBind(n,r){return new Promise((i,a)=>{let o=(0,e.createServer)((e,t)=>{t.writeHead(400).end(`WebSocket endpoint`)});o.on(`error`,e=>{o.close(),a(e)}),o.listen(r,`127.0.0.1`,()=>{let e=new t.WebSocketServer({server:o});e.on(`connection`,e=>{let r=n=>{e.readyState===t.WebSocket.OPEN&&e.send(JSON.stringify(n))},{onMessage:i,cleanup:a}=u({session:n,send:r});e.on(`message`,e=>i(String(e))),e.on(`close`,a),e.on(`error`,a),r({type:`messages`,messages:n.getMessages()}),r({type:`execution_workspace_event`,snapshot:n.getExecutionWorkspaceSnapshot()})}),i({stop:()=>new Promise(t=>{e.close(()=>o.close(()=>t()))})})})})}};Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return w}});
+require(`./tui-BIpIcT7-.cjs`);let e=require(`node:http`),t=require(`ws`);function n(e,t,n){if(n.type===`get-background-tasks`){t({type:`background_tasks`,tasks:e.listBackgroundTasks(n.filter)});return}if(n.type===`get-background-task`){i(e,t,n);return}if(n.type===`get-background-job-groups`){t({type:`background_job_groups`,groups:e.listBackgroundJobGroups()});return}if(n.type===`get-background-job-group`){o(e,t,n);return}if(n.type===`wait-background-job-group`){s(e,t,n);return}a(e,t,n)}function r(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}if(n.type===`cancel-background-task`){l(t,`cancel`,n.taskId,e.cancelBackgroundTask(n.taskId,n.reason));return}if(n.type===`close-background-task`){l(t,`close`,n.taskId,e.closeBackgroundTask(n.taskId));return}c(e,t,n)}function i(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}t({type:`background_task`,taskId:n.taskId,task:e.getBackgroundTask(n.taskId)??null})}function a(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}e.readBackgroundTaskLog(n.taskId,n.cursor).then(e=>t({type:`background_task_log`,taskId:n.taskId,page:e}),e=>t({type:`protocol_error`,message:e.message}))}function o(e,t,n){if(!n.groupId){t({type:`protocol_error`,message:`groupId is required`});return}t({type:`background_job_group`,groupId:n.groupId,group:e.getBackgroundJobGroup(n.groupId)??null})}function s(e,t,n){if(!n.groupId){t({type:`protocol_error`,message:`groupId is required`});return}e.waitBackgroundJobGroup(n.groupId).then(e=>t({type:`background_job_group`,groupId:n.groupId,group:e}),e=>t({type:`protocol_error`,message:e.message}))}function c(e,t,n){if(!n.input){t({type:`protocol_error`,message:`input is required`});return}l(t,`send`,n.taskId,e.sendBackgroundTask(n.taskId,n.input))}function l(e,t,n,r){r.then(()=>e({type:`background_task_control_result`,action:t,taskId:n,success:!0}),r=>e({type:`background_task_control_result`,action:t,taskId:n,success:!1,message:r.message}))}function u(e){let t=d(e.session,e.send);return{onMessage:f(e.session,e.send),cleanup:t}}function d(e,t){let n=e=>t({type:`user_message`,content:e}),r=e=>t({type:`text_delta`,delta:e}),i=e=>t({type:`tool_start`,state:e}),a=e=>t({type:`tool_end`,state:e}),o=e=>t({type:`thinking`,isThinking:e}),s=e=>t({type:`complete`,result:e}),c=e=>t({type:`interrupted`,result:e}),l=e=>t({type:`error`,message:e.message}),u=e=>t({type:`background_task_event`,event:e}),d=e=>t({type:`background_job_group_event`,event:e}),f=e=>t({type:`execution_workspace_event`,snapshot:e.snapshot});return e.on(`user_message`,n),e.on(`text_delta`,r),e.on(`tool_start`,i),e.on(`tool_end`,a),e.on(`thinking`,o),e.on(`complete`,s),e.on(`interrupted`,c),e.on(`error`,l),e.on(`background_task_event`,u),e.on(`background_job_group_event`,d),e.on(`execution_workspace_event`,f),()=>{e.off(`user_message`,n),e.off(`text_delta`,r),e.off(`tool_start`,i),e.off(`tool_end`,a),e.off(`thinking`,o),e.off(`complete`,s),e.off(`interrupted`,c),e.off(`error`,l),e.off(`background_task_event`,u),e.off(`background_job_group_event`,d),e.off(`execution_workspace_event`,f)}}function f(e,t){return n=>{let r=p(n,t);r&&m(e,t,r)}}function p(e,t){try{return JSON.parse(e)}catch{return t({type:`protocol_error`,message:`Invalid JSON`}),null}}function m(e,t,i){if(g(i)){b(e,t,i);return}if(_(i)){x(e,t,i);return}if(v(i)){n(e,t,i);return}if(y(i)){r(e,t,i);return}t({type:`protocol_error`,message:`Unknown message type: ${h(i)}`})}function h(e){return e.type}function g(e){return e.type===`submit`||e.type===`command`||e.type===`abort`||e.type===`cancel-queue`}function _(e){return e.type===`get-messages`||e.type===`get-context`||e.type===`get-executing`||e.type===`get-pending`||e.type===`get-execution-workspace`}function v(e){return e.type===`get-background-tasks`||e.type===`get-background-task`||e.type===`read-background-task-log`||e.type===`get-background-job-groups`||e.type===`get-background-job-group`||e.type===`wait-background-job-group`}function y(e){return e.type===`cancel-background-task`||e.type===`close-background-task`||e.type===`send-background-task`}function b(e,t,n){if(n.type===`submit`){if(!n.prompt){t({type:`protocol_error`,message:`prompt is required`});return}e.submit(n.prompt)}else if(n.type===`command`){if(!n.name){t({type:`protocol_error`,message:`name is required`});return}e.executeCommand(n.name,n.args??``).then(e=>{t({type:`command_result`,name:n.name,message:e?.message??`Unknown command: ${n.name}`,success:e?.success??!1,data:e?.data})})}else n.type===`abort`?e.abort():e.cancelQueue()}function x(e,t,n){n.type===`get-messages`?t({type:`messages`,messages:e.getMessages()}):n.type===`get-context`?t({type:`context`,state:e.getContextState()}):n.type===`get-executing`?t({type:`executing`,executing:e.isExecuting()}):n.type===`get-execution-workspace`?t({type:`execution_workspace_event`,snapshot:e.getExecutionWorkspaceSnapshot()}):t({type:`pending`,pending:e.getPendingPrompt()})}function S(e){let t=null,n=null;return{name:`ws`,onMessage:null,attach(e){t=e},async start(){if(!t)throw Error(`No session attached. Call attach() first.`);let r=u({session:t,send:e.send});n=r.cleanup,this.onMessage=r.onMessage},async stop(){n?.(),n=null,this.onMessage=null}}}const C=7070;var w=class{name=`ws`;defaultEnabled=!0;optionsSchema={port:{type:`number`,description:`WebSocket server port`,default:C},maxRetries:{type:`number`,description:`Port retry attempts when port is occupied`,default:20}};session=null;stopFn=null;port;maxRetries;constructor(e={}){this.port=e.port??C,this.maxRetries=e.maxRetries??20}attach(e){this.session=e}async start(){if(!this.session)throw Error(`WsTransport: attach() must be called before start()`);let e=await this.bindWithRetry(this.session,this.port,this.maxRetries);this.stopFn=e.stop}async stop(){await this.stopFn?.(),this.stopFn=null}validateOptions(e){let{port:t,maxRetries:n}=e;return!(t!==void 0&&(typeof t!=`number`||t<1||t>65535)||n!==void 0&&(typeof n!=`number`||n<0))}bindWithRetry(e,t,n){return this.tryBind(e,t).catch(r=>{if(r.code===`EADDRINUSE`&&n>0)return this.bindWithRetry(e,t+1,n-1);throw r})}tryBind(n,r){return new Promise((i,a)=>{let o=(0,e.createServer)((e,t)=>{t.writeHead(400).end(`WebSocket endpoint`)});o.on(`error`,e=>{o.close(),a(e)}),o.listen(r,`127.0.0.1`,()=>{let e=new t.WebSocketServer({server:o});e.on(`connection`,e=>{let r=n=>{e.readyState===t.WebSocket.OPEN&&e.send(JSON.stringify(n))},{onMessage:i,cleanup:a}=u({session:n,send:r});e.on(`message`,e=>i(String(e))),e.on(`close`,a),e.on(`error`,a),r({type:`messages`,messages:n.getMessages()}),r({type:`execution_workspace_event`,snapshot:n.getExecutionWorkspaceSnapshot()})}),i({stop:()=>new Promise(t=>{e.close(()=>o.close(()=>t()))})})})})}};Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return w}});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robota-sdk/agent-transport",
-  "version": "3.0.0-beta.64",
+  "version": "3.0.0-beta.65",
   "description": "Consolidated transport package for Robota SDK — TUI, headless, HTTP, WebSocket, and MCP adapters",
   "type": "module",
   "main": "dist/node/index.js",
@@ -108,9 +108,9 @@
     "string-width": "^8.2.0",
     "ws": "^8.18.3",
     "zod": "^3.24.4",
-    "@robota-sdk/agent-interface-transport": "3.0.0-beta.64",
-    "@robota-sdk/agent-core": "3.0.0-beta.64",
-    "@robota-sdk/agent-framework": "3.0.0-beta.64"
+    "@robota-sdk/agent-core": "3.0.0-beta.65",
+    "@robota-sdk/agent-interface-transport": "3.0.0-beta.65",
+    "@robota-sdk/agent-framework": "3.0.0-beta.65"
   },
   "devDependencies": {
     "@homebridge/node-pty-prebuilt-multiarch": "^0.13.1",
@@ -123,7 +123,7 @@
     "tsx": "^4.7.0",
     "typescript": "^5.3.3",
     "vitest": "^1.6.1",
-    "@robota-sdk/agent-command": "3.0.0-beta.64"
+    "@robota-sdk/agent-command": "3.0.0-beta.65"
   },
   "license": "MIT",
   "publishConfig": {

package/src/tui/App.tsx

@@ -41,6 +41,7 @@ import {
 import { TuiCliAdapterProvider } from './tui-cli-adapter-context.js';
 import type { ITuiCliAdapter } from './tui-cli-adapter.js';
 import type { CommandRegistry } from '@robota-sdk/agent-framework';
+import type { ITuiCommandInteraction } from './command-interaction.js';
 
 interface IProps {
   cwd: string;
@@ -67,6 +68,7 @@ interface IProps {
   cliAdapter: ITuiCliAdapter;
   reloadPluginCommandSource?: (registry: CommandRegistry) => void;
   agentName?: string;
+  resolveInteraction?: (commandName: string) => ITuiCommandInteraction | undefined;
 }
 
 export default function App(props: IProps): React.ReactElement {
@@ -470,6 +472,7 @@ function AppInner(
         registry={registry}
         sessionName={sessionName}
         history={history}
+        resolveInteraction={props.resolveInteraction}
       />
       {/* Permanent blank line below input — required for Korean IME stability. */}
       <Text> </Text>

package/src/tui/InputArea.tsx

@@ -8,6 +8,8 @@ import type { CommandRegistry, ICommand } from '@robota-sdk/agent-framework';
 import CjkTextInput from './CjkTextInput.js';
 import WaveText from './WaveText.js';
 import SlashAutocomplete from './SlashAutocomplete.js';
+import CommandPicker from './interactions/CommandPicker.js';
+import CommandConfirm from './interactions/CommandConfirm.js';
 import { expandPasteLabels } from './utils/paste-labels.js';
 import { useAutocomplete } from './hooks/useAutocomplete.js';
 import {
@@ -24,6 +26,17 @@ import {
   resolveTabCompletion,
   shouldSubmitInput,
 } from './flows/input-area-flow.js';
+import {
+  isPickerInteraction,
+  isConfirmInteraction,
+  type ITuiCommandInteraction,
+  type ITuiPickerItem,
+} from './command-interaction.js';
+
+interface IActiveInteraction {
+  commandName: string;
+  interaction: ITuiCommandInteraction;
+}
 
 interface IProps {
   onSubmit: (value: string) => void;
@@ -34,6 +47,7 @@ interface IProps {
   registry?: CommandRegistry;
   sessionName?: string;
   history?: readonly IHistoryEntry[];
+  resolveInteraction?: (commandName: string) => ITuiCommandInteraction | undefined;
 }
 
 /**
@@ -65,9 +79,11 @@ export default function InputArea({
   registry,
   sessionName,
   history,
+  resolveInteraction,
 }: IProps): React.ReactElement {
   const [value, setValue] = useState('');
   const [cursorHint, setCursorHint] = useState<number | null>(null);
+  const [activeInteraction, setActiveInteraction] = useState<IActiveInteraction | null>(null);
   const [historyState, setHistoryState] = useState(createPromptHistoryNavigationState);
   const [localPromptHistory, setLocalPromptHistory] = useState<string[]>([]);
   const restoredPromptHistory = useMemo(() => extractPromptHistory(history ?? []), [history]);
@@ -139,7 +155,8 @@ export default function InputArea({
   /** Enter: insert and execute command immediately */
   const enterSelectCommand = useCallback(
     (cmd: ICommand): void => {
-      const result = resolveEnterCommandSelection(value, cmd);
+      const interaction = resolveInteraction?.(cmd.name);
+      const result = resolveEnterCommandSelection(value, cmd, interaction);
       if (result.type === 'insert') {
         setValue(result.value);
         if (result.selectedIndex !== undefined) {
@@ -147,10 +164,17 @@ export default function InputArea({
         }
         return;
       }
-      setValue('');
-      submitPrompt(result.value);
+      if (result.type === 'open-interaction' && interaction?.onMissingArgs) {
+        setShowPopup(false);
+        setActiveInteraction({ commandName: result.commandName, interaction });
+        return;
+      }
+      if (result.type === 'submit') {
+        setValue('');
+        submitPrompt(result.value);
+      }
     },
-    [value, submitPrompt, setSelectedIndex],
+    [value, submitPrompt, setSelectedIndex, resolveInteraction, setShowPopup],
   );
 
   const handleSubmit = useCallback(
@@ -238,9 +262,44 @@ export default function InputArea({
     return { left: '┌' + '─'.repeat(innerWidth), label: '', right: '┐' };
   })();
 
+  const handlePickerSelect = useCallback(
+    (item: ITuiPickerItem): void => {
+      if (!activeInteraction) return;
+      setActiveInteraction(null);
+      submitPrompt(`/${activeInteraction.commandName} ${item.value}`);
+    },
+    [activeInteraction, submitPrompt],
+  );
+
+  const handleConfirm = useCallback((): void => {
+    if (!activeInteraction) return;
+    setActiveInteraction(null);
+    submitPrompt(`/${activeInteraction.commandName}`);
+  }, [activeInteraction, submitPrompt]);
+
+  const handleInteractionCancel = useCallback((): void => {
+    setActiveInteraction(null);
+  }, []);
+
   return (
     <Box flexDirection="column">
-      {showPopup && (
+      {activeInteraction && isPickerInteraction(activeInteraction.interaction) && (
+        <CommandPicker
+          commandName={activeInteraction.commandName}
+          interaction={activeInteraction.interaction}
+          onSelect={handlePickerSelect}
+          onCancel={handleInteractionCancel}
+        />
+      )}
+      {activeInteraction && isConfirmInteraction(activeInteraction.interaction) && (
+        <CommandConfirm
+          commandName={activeInteraction.commandName}
+          interaction={activeInteraction.interaction}
+          onConfirm={handleConfirm}
+          onCancel={handleInteractionCancel}
+        />
+      )}
+      {!activeInteraction && showPopup && (
         <SlashAutocomplete
           commands={filteredCommands}
           selectedIndex={selectedIndex}

package/src/tui/SlashAutocomplete.tsx

@@ -51,8 +51,7 @@ function CommandRow(props: {
   const indicator = isSelected ? '▸ ' : '  ';
   const nameColor = isSelected ? 'cyan' : undefined;
   const dimmed = !isSelected;
-  const displayLabel = cmd.displayName ?? cmd.name;
-  const namePart = capName(displayLabel, nameColWidth);
+  const namePart = capName(cmd.name, nameColWidth);
   const text = showSlash
     ? `${indicator}/${namePart}  ${cmd.description ?? ''}`
     : `${indicator}${namePart}  ${cmd.description ?? ''}`;
@@ -82,7 +81,7 @@ export default function SlashAutocomplete({
 
   const nameColWidth = Math.min(
     NAME_COL_MAX,
-    Math.max(...visibleCommands.map((c) => (c.displayName ?? c.name).length)),
+    Math.max(...visibleCommands.map((c) => c.name.length)),
   );
 
   return (

package/src/tui/__tests__/input-area-flow.test.ts

@@ -14,6 +14,7 @@ import {
   shouldSubmitInput,
 } from '../flows/input-area-flow.js';
 import type { ICommand } from '@robota-sdk/agent-framework';
+import type { ITuiPickerInteraction } from '../command-interaction.js';
 import {
   createAssistantMessage,
   createSystemMessage,
@@ -66,6 +67,24 @@ describe('input area flow', () => {
     expect(result).toEqual({ type: 'submit', value: '/help' });
   });
 
+  it('Given interaction declared and no args When enter selects command Then open-interaction is returned', () => {
+    const result = resolveEnterCommandSelection('/ex', command('exit'), {
+      onMissingArgs: 'confirm',
+    });
+
+    expect(result).toEqual({ type: 'open-interaction', commandName: 'exit' });
+  });
+
+  it('Given interaction declared but subcommand selected (args present) When enter selects Then submits', () => {
+    const pickerInteraction: ITuiPickerInteraction = {
+      onMissingArgs: 'picker',
+      getItems: () => [],
+    };
+    const result = resolveEnterCommandSelection('/mode plan', command('plan'), pickerInteraction);
+
+    expect(result).toEqual({ type: 'submit', value: '/mode plan' });
+  });
+
   it('Given multiline paste When label change is created Then label is inserted at cursor', () => {
     const result = createPasteLabelChange('abef', 2, 7, 'c\nd\ne');
 

package/src/tui/command-interaction.ts

@@ -0,0 +1,35 @@
+export type TOnMissingArgsAction = 'picker' | 'wizard' | 'confirm';
+
+export interface ITuiPickerItem {
+  label: string;
+  value: string;
+  description?: string;
+}
+
+export interface ITuiCommandInteraction {
+  onMissingArgs?: TOnMissingArgsAction;
+}
+
+export interface ITuiPickerInteraction extends ITuiCommandInteraction {
+  onMissingArgs: 'picker';
+  getItems(): ITuiPickerItem[];
+}
+
+export interface ITuiConfirmInteraction extends ITuiCommandInteraction {
+  onMissingArgs: 'confirm';
+  message: string;
+}
+
+export type TAnyTuiCommandInteraction = ITuiPickerInteraction | ITuiConfirmInteraction;
+
+export function isPickerInteraction(
+  interaction: ITuiCommandInteraction,
+): interaction is ITuiPickerInteraction {
+  return interaction.onMissingArgs === 'picker';
+}
+
+export function isConfirmInteraction(
+  interaction: ITuiCommandInteraction,
+): interaction is ITuiConfirmInteraction {
+  return interaction.onMissingArgs === 'confirm';
+}

package/src/tui/flows/input-area-flow.ts

@@ -1,6 +1,7 @@
 import type { IHistoryEntry, TUniversalValue } from '@robota-sdk/agent-core';
 import type { ICommand } from '@robota-sdk/agent-framework';
 import { parseSlashInput } from '../hooks/useAutocomplete.js';
+import type { ITuiCommandInteraction } from '../command-interaction.js';
 
 export interface IAutocompleteInputKey {
   upArrow?: boolean;
@@ -17,7 +18,8 @@ export type TPromptHistoryInputAction = 'previous' | 'next';
 
 export type TCommandSelectionResult =
   | { type: 'insert'; value: string; selectedIndex?: number }
-  | { type: 'submit'; value: string };
+  | { type: 'submit'; value: string }
+  | { type: 'open-interaction'; commandName: string };
 
 export interface IPasteLabelChange {
   value: string;
@@ -154,11 +156,16 @@ export function resolveTabCompletion(value: string, command: ICommand): TCommand
 export function resolveEnterCommandSelection(
   value: string,
   command: ICommand,
+  interaction?: ITuiCommandInteraction,
 ): TCommandSelectionResult {
   const parsed = parseSlashInput(value);
   if (parsed.parentCommand) {
     return { type: 'submit', value: `/${parsed.parentCommand} ${command.name}` };
   }
+  // parentCommand is empty → no args provided beyond the command name itself
+  if (interaction?.onMissingArgs) {
+    return { type: 'open-interaction', commandName: command.name };
+  }
   if (command.subcommands && command.subcommands.length > 0) {
     return { type: 'insert', value: `/${command.name} `, selectedIndex: 0 };
   }

package/src/tui/index.ts

@@ -1,3 +1,11 @@
 export { TuiTransport } from './tui-transport.js';
 export type { ITuiCliAdapter } from './tui-cli-adapter.js';
 export type { IRenderOptions } from './render.js';
+export type {
+  TOnMissingArgsAction,
+  ITuiPickerItem,
+  ITuiCommandInteraction,
+  ITuiPickerInteraction,
+  ITuiConfirmInteraction,
+  TAnyTuiCommandInteraction,
+} from './command-interaction.js';

package/src/tui/interactions/CommandConfirm.tsx

@@ -0,0 +1,35 @@
+import React from 'react';
+import { Box, Text, useInput } from 'ink';
+import type { ITuiConfirmInteraction } from '../command-interaction.js';
+
+interface IProps {
+  commandName: string;
+  interaction: ITuiConfirmInteraction;
+  onConfirm: () => void;
+  onCancel: () => void;
+}
+
+export default function CommandConfirm({
+  commandName,
+  interaction,
+  onConfirm,
+  onCancel,
+}: IProps): React.ReactElement {
+  useInput((input, key) => {
+    if (key.return || input === 'y' || input === 'Y') {
+      onConfirm();
+    } else if (key.escape || input === 'n' || input === 'N') {
+      onCancel();
+    }
+  });
+
+  return (
+    <Box paddingX={1}>
+      <Text bold color="yellow">
+        /{commandName}:{' '}
+      </Text>
+      <Text>{interaction.message} </Text>
+      <Text dimColor>[y/n]</Text>
+    </Box>
+  );
+}

package/src/tui/interactions/CommandPicker.tsx

@@ -0,0 +1,76 @@
+import React, { useState } from 'react';
+import { Box, Text, useInput, useStdout } from 'ink';
+import type { ITuiPickerInteraction, ITuiPickerItem } from '../command-interaction.js';
+
+interface IProps {
+  commandName: string;
+  interaction: ITuiPickerInteraction;
+  onSelect: (item: ITuiPickerItem) => void;
+  onCancel: () => void;
+}
+
+const MAX_VISIBLE = 8;
+const OUTER_CHROME = 4;
+const MIN_ROW_WIDTH = 40;
+
+function useRowWidth(): number {
+  const { stdout } = useStdout();
+  return Math.max(MIN_ROW_WIDTH, (stdout.columns ?? 80) - OUTER_CHROME);
+}
+
+export default function CommandPicker({
+  commandName,
+  interaction,
+  onSelect,
+  onCancel,
+}: IProps): React.ReactElement {
+  const items = interaction.getItems();
+  const [selectedIndex, setSelectedIndex] = useState(0);
+  const rowWidth = useRowWidth();
+
+  useInput((input, key) => {
+    if (key.upArrow) {
+      setSelectedIndex((i) => (i > 0 ? i - 1 : items.length - 1));
+    } else if (key.downArrow) {
+      setSelectedIndex((i) => (i < items.length - 1 ? i + 1 : 0));
+    } else if (key.return) {
+      const item = items[selectedIndex];
+      if (item) onSelect(item);
+    } else if (key.escape || input === 'q') {
+      onCancel();
+    }
+  });
+
+  const scrollOffset = (() => {
+    if (items.length <= MAX_VISIBLE) return 0;
+    if (selectedIndex < MAX_VISIBLE) return 0;
+    return Math.min(selectedIndex - MAX_VISIBLE + 1, items.length - MAX_VISIBLE);
+  })();
+  const visibleItems = items.slice(scrollOffset, scrollOffset + MAX_VISIBLE);
+
+  return (
+    <Box flexDirection="column" borderStyle="round" borderColor="cyan" paddingX={1}>
+      <Text bold color="cyan">
+        /{commandName}
+      </Text>
+      {visibleItems.map((item, i) => {
+        const isSelected = scrollOffset + i === selectedIndex;
+        const indicator = isSelected ? '▸ ' : '  ';
+        return (
+          <Box key={item.value} width={rowWidth}>
+            <Text
+              color={isSelected ? 'cyan' : undefined}
+              dimColor={!isSelected}
+              wrap="truncate-end"
+            >
+              {indicator}
+              {item.label}
+              {item.description != null ? `  ${item.description}` : ''}
+            </Text>
+          </Box>
+        );
+      })}
+      <Text dimColor>↑↓ navigate · Enter select · Esc cancel</Text>
+    </Box>
+  );
+}

package/src/tui/render.tsx

@@ -19,6 +19,7 @@ import type {
 } from '@robota-sdk/agent-framework';
 import type { ITransportRegistryView } from '@robota-sdk/agent-interface-transport';
 import type { ITuiCliAdapter } from './tui-cli-adapter.js';
+import type { ITuiCommandInteraction } from './command-interaction.js';
 
 export interface IRenderOptions {
   cwd: string;
@@ -45,6 +46,7 @@ export interface IRenderOptions {
   cliAdapter: ITuiCliAdapter;
   reloadPluginCommandSource?: (registry: CommandRegistry) => void;
   agentName?: string;
+  resolveInteraction?: (commandName: string) => ITuiCommandInteraction | undefined;
 }
 
 export async function renderApp(options: IRenderOptions): Promise<void> {

package/dist/node/index--Ti9NzQX.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index--Ti9NzQX.d.ts","names":[],"sources":["../../src/tui/tui-cli-adapter.ts","../../src/tui/render.tsx","../../src/tui/tui-transport.ts"],"mappings":";;;;;UAOiB,cAAA;EACf,mBAAA;EACA,YAAA,CAAa,IAAA,WAAe,MAAA,SAAe,eAAA;EAC3C,aAAA,CAAc,IAAA,UAAc,QAAA,EAAU,MAAA,SAAe,eAAA;EACrD,cAAA,CAAe,IAAA;EACf,uBAAA,CACE,IAAA,UACA,KAAA,EAAO,+BAAA,GACN,0BAAA;EACH,yBAAA,CAA0B,QAAA,EAAU,eAAA;EACpC,sBAAA,CACE,GAAA,UACA,OAAA,UACA,OAAA;IAAY,gBAAA;EAAA;IACT,OAAA;EAAA;EACL,YAAA,CAAa,GAAA;EACb,sBAAA,CAAuB,IAAA;AAAA;;;UCDR,cAAA;EACf,GAAA;EACA,QAAA,EAAU,WAAA;EACV,gBAAA;EACA,YAAA;EACA,OAAA;EACA,QAAA;EACA,cAAA,GAAiB,eAAA;EACjB,QAAA;EACA,OAAA;EACA,YAAA,GAAe,wBAAA;EACf,eAAA;EACA,wBAAA;EACA,WAAA;EACA,WAAA;EACA,qBAAA,GAAwB,qBAAA;EACxB,qBAAA,GAAwB,sBAAA;EACxB,cAAA,YAA0B,cAAA;EAC1B,mBAAA,GAAsB,oBAAA;EACtB,SAAA,GAAY,YAAA;EACZ,mBAAA,GAAsB,OAAA;EACtB,iBAAA,GAAoB,sBAAA,CAAuB,mBAAA;EAC3C,UAAA,EAAY,cAAA;EACZ,yBAAA,IAA6B,QAAA,EAAU,eAAA;EACvC,SAAA;AAAA;;;cCzCW,YAAA,YAAwB,sBAAA,CAAuB,mBAAA;EAAA,SACjD,IAAA;EAAA,SACA,cAAA;EAAA,SACA,aAAA;EAAA,iBAEQ,OAAA;cAEL,OAAA,EAAS,cAAA;EAIrB,MAAA,CAAO,QAAA,EAAU,mBAAA;EAIX,KAAA,CAAA,GAAS,OAAA;EAIT,IAAA,CAAA,GAAQ,OAAA;EAId,eAAA,CAAgB,QAAA,EAAU,MAAA,SAAe,eAAA;AAAA"}

package/dist/node/index-CAr3ioVh.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-CAr3ioVh.d.ts","names":[],"sources":["../../src/tui/tui-cli-adapter.ts","../../src/tui/render.tsx","../../src/tui/tui-transport.ts"],"mappings":";;;;;UAOiB,cAAA;EACf,mBAAA;EACA,YAAA,CAAa,IAAA,WAAe,MAAA,SAAe,eAAA;EAC3C,aAAA,CAAc,IAAA,UAAc,QAAA,EAAU,MAAA,SAAe,eAAA;EACrD,cAAA,CAAe,IAAA;EACf,uBAAA,CACE,IAAA,UACA,KAAA,EAAO,+BAAA,GACN,0BAAA;EACH,yBAAA,CAA0B,QAAA,EAAU,eAAA;EACpC,sBAAA,CACE,GAAA,UACA,OAAA,UACA,OAAA;IAAY,gBAAA;EAAA;IACT,OAAA;EAAA;EACL,YAAA,CAAa,GAAA;EACb,sBAAA,CAAuB,IAAA;AAAA;;;UCDR,cAAA;EACf,GAAA;EACA,QAAA,EAAU,WAAA;EACV,gBAAA;EACA,YAAA;EACA,OAAA;EACA,QAAA;EACA,cAAA,GAAiB,eAAA;EACjB,QAAA;EACA,OAAA;EACA,YAAA,GAAe,wBAAA;EACf,eAAA;EACA,wBAAA;EACA,WAAA;EACA,WAAA;EACA,qBAAA,GAAwB,qBAAA;EACxB,qBAAA,GAAwB,sBAAA;EACxB,cAAA,YAA0B,cAAA;EAC1B,mBAAA,GAAsB,oBAAA;EACtB,SAAA,GAAY,YAAA;EACZ,mBAAA,GAAsB,OAAA;EACtB,iBAAA,GAAoB,sBAAA,CAAuB,mBAAA;EAC3C,UAAA,EAAY,cAAA;EACZ,yBAAA,IAA6B,QAAA,EAAU,eAAA;EACvC,SAAA;AAAA;;;cCzCW,YAAA,YAAwB,sBAAA,CAAuB,mBAAA;EAAA,SACjD,IAAA;EAAA,SACA,cAAA;EAAA,SACA,aAAA;EAAA,iBAEQ,OAAA;cAEL,OAAA,EAAS,cAAA;EAIrB,MAAA,CAAO,QAAA,EAAU,mBAAA;EAIX,KAAA,CAAA,GAAS,OAAA;EAIT,IAAA,CAAA,GAAQ,OAAA;EAId,eAAA,CAAgB,QAAA,EAAU,MAAA,SAAe,eAAA;AAAA"}