@robota-sdk/agent-cli 3.0.0-beta.46 → 3.0.0-beta.47

package/README.md

@@ -78,10 +78,33 @@ robota --model <model>              # Model override (e.g., claude-sonnet-4-6)
 robota --language <lang>            # Response language (ko, en, ja, zh)
 robota --permission-mode <mode>     # plan | default | acceptEdits | bypassPermissions
 robota --max-turns <n>              # Limit agentic turns per interaction
+robota --output-format <fmt>        # text | json | stream-json (print mode)
+robota --system-prompt <text>       # Replace system prompt (print mode)
+robota --append-system-prompt <text> # Append to system prompt (print mode)
 robota --reset                      # Delete user settings and exit
 robota --version                    # Show version
 ```
 
+### Print Mode Output Formats
+
+Print mode (`-p`) supports three output formats via `--output-format`:
+
+| Format        | Description                                                        |
+| ------------- | ------------------------------------------------------------------ |
+| `text`        | Plain text response to stdout (default)                            |
+| `json`        | Single JSON object: `{ type, result, session_id, subtype }`        |
+| `stream-json` | Newline-delimited JSON with `content_block_delta` streaming events |
+
+### Stdin Pipe
+
+When `-p` is used without a positional argument and stdin is piped, the CLI reads from stdin:
+
+```bash
+echo "Explain this error" | robota -p
+cat file.ts | robota -p "Review this code" --output-format json
+git diff | robota -p "Summarize changes" --output-format stream-json
+```
+
 ## First-Run Setup
 
 When no settings file exists, the CLI prompts for:
@@ -227,7 +250,7 @@ When a session has a name, it appears in three places:
 | `/rename <name>`          | Rename the current session                                 |
 | `/exit`                   | Exit CLI                                                   |
 
-Typing `/` triggers an autocomplete popup with arrow-key navigation, Tab completion, and Esc to dismiss. Commands with subcommands (e.g., `/mode`, `/model`) show a nested submenu. Skill commands discovered from `.agents/skills/` and `.claude/commands/` appear alongside built-in commands.
+Typing `/` triggers an autocomplete popup with arrow-key navigation and Esc to dismiss. Tab inserts the highlighted command into the input field without executing — continue typing args or press Enter to execute. Enter selects and executes immediately. Commands with subcommands (e.g., `/mode`, `/model`) show a nested submenu. Skill commands discovered from `.agents/skills/` and `.claude/commands/` appear alongside built-in commands.
 
 ## Plugin Management
 
@@ -317,18 +340,19 @@ bin.ts → cli.ts (arg parsing)
 
 ## Dependencies
 
-| Package                     | Purpose                                    |
-| --------------------------- | ------------------------------------------ |
-| `@robota-sdk/agent-sdk`     | Session factory, query, config, context    |
-| `@robota-sdk/agent-core`    | Types (TPermissionMode, TToolArgs)         |
-| `ink`, `react`              | TUI rendering                              |
-| `ink-select-input`          | Arrow-key selection (permission prompt)    |
-| `ink-spinner`               | Loading spinner                            |
-| `chalk`                     | Terminal colors                            |
-| `ink-text-input`            | Base text input (extended by CjkTextInput) |
-| `marked`, `marked-terminal` | Markdown parsing and terminal rendering    |
-| `cli-highlight`             | Syntax highlighting for code blocks        |
-| `string-width`              | Unicode-aware string width (CJK support)   |
+| Package                                | Purpose                                    |
+| -------------------------------------- | ------------------------------------------ |
+| `@robota-sdk/agent-sdk`                | Session factory, query, config, context    |
+| `@robota-sdk/agent-core`               | Types (TPermissionMode, TToolArgs)         |
+| `@robota-sdk/agent-transport-headless` | Headless runner for print mode (`-p`)      |
+| `ink`, `react`                         | TUI rendering                              |
+| `ink-select-input`                     | Arrow-key selection (permission prompt)    |
+| `ink-spinner`                          | Loading spinner                            |
+| `chalk`                                | Terminal colors                            |
+| `ink-text-input`                       | Base text input (extended by CjkTextInput) |
+| `marked`, `marked-terminal`            | Markdown parsing and terminal rendering    |
+| `cli-highlight`                        | Syntax highlighting for code blocks        |
+| `string-width`                         | Unicode-aware string width (CJK support)   |
 
 ## Documentation
 

package/dist/node/bin.js

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

package/dist/node/{chunk-L5G6WFOL.js → chunk-74WEPZG2.js}

@@ -40,6 +40,9 @@ function parseCliArgs() {
       "max-turns": { type: "string" },
       "fork-session": { type: "boolean", default: false },
       name: { type: "string", short: "n" },
+      "output-format": { type: "string" },
+      "system-prompt": { type: "string" },
+      "append-system-prompt": { type: "string" },
       version: { type: "boolean", default: false },
       reset: { type: "boolean", default: false }
     }
@@ -55,6 +58,9 @@ function parseCliArgs() {
     maxTurns: parseMaxTurns(values["max-turns"]),
     forkSession: values["fork-session"] ?? false,
     sessionName: values["name"],
+    outputFormat: values["output-format"],
+    systemPrompt: values["system-prompt"],
+    appendSystemPrompt: values["append-system-prompt"],
     version: values["version"] ?? false,
     reset: values["reset"] ?? false
   };
@@ -134,6 +140,9 @@ function createProviderFromSettings(cwd, modelOverride) {
   }
 }
 
+// src/cli.ts
+import { createHeadlessTransport } from "@robota-sdk/agent-transport-headless";
+
 // src/ui/render.tsx
 import { render } from "ink";
 
@@ -911,9 +920,7 @@ function CjkTextInput({
   const pasteBufferRef = useRef2("");
   if (value !== valueRef.current) {
     valueRef.current = value;
-    if (cursorRef.current > value.length) {
-      cursorRef.current = value.length;
-    }
+    cursorRef.current = value.length;
   }
   useInput(
     (input, key) => {
@@ -1194,23 +1201,23 @@ function InputArea({
     const label = `[Pasted text #${id} +${lineCount} lines]`;
     setValue((prev) => prev ? `${prev} ${label}` : label);
   }, []);
-  const handleSubmit = useCallback2(
-    (text) => {
-      const trimmed = text.trim();
-      if (trimmed.length === 0) return;
-      if (showPopup && filteredCommands[selectedIndex]) {
-        selectCommand(filteredCommands[selectedIndex]);
+  const tabCompleteCommand = useCallback2(
+    (cmd) => {
+      const parsed = parseSlashInput(value);
+      if (parsed.parentCommand) {
+        setValue(`/${parsed.parentCommand} ${cmd.name} `);
         return;
       }
-      const expanded = expandPasteLabels(trimmed, pasteStore.current);
-      setValue("");
-      pasteStore.current.clear();
-      pasteIdRef.current = 0;
-      onSubmit(expanded);
+      if (cmd.subcommands && cmd.subcommands.length > 0) {
+        setValue(`/${cmd.name} `);
+        setSelectedIndex(0);
+        return;
+      }
+      setValue(`/${cmd.name} `);
     },
-    [showPopup, filteredCommands, selectedIndex, onSubmit]
+    [value, setSelectedIndex]
   );
-  const selectCommand = useCallback2(
+  const enterSelectCommand = useCallback2(
     (cmd) => {
       const parsed = parseSlashInput(value);
       if (parsed.parentCommand) {
@@ -1229,6 +1236,22 @@ function InputArea({
     },
     [value, onSubmit, setSelectedIndex]
   );
+  const handleSubmit = useCallback2(
+    (text) => {
+      const trimmed = text.trim();
+      if (trimmed.length === 0) return;
+      if (showPopup && filteredCommands[selectedIndex]) {
+        enterSelectCommand(filteredCommands[selectedIndex]);
+        return;
+      }
+      const expanded = expandPasteLabels(trimmed, pasteStore.current);
+      setValue("");
+      pasteStore.current.clear();
+      pasteIdRef.current = 0;
+      onSubmit(expanded);
+    },
+    [showPopup, filteredCommands, selectedIndex, onSubmit, enterSelectCommand]
+  );
   useInput2(
     (_input, key) => {
       if (!showPopup) return;
@@ -1240,7 +1263,7 @@ function InputArea({
         setShowPopup(false);
       } else if (key.tab) {
         const cmd = filteredCommands[selectedIndex];
-        if (cmd) selectCommand(cmd);
+        if (cmd) tabCompleteCommand(cmd);
       }
     },
     { isActive: showPopup && !isDisabled }
@@ -2446,8 +2469,15 @@ async function startCli() {
     }
   }
   if (args.printMode) {
-    const prompt = args.positional.join(" ").trim();
-    if (prompt.length === 0) {
+    let prompt = args.positional.join(" ").trim();
+    if (!prompt && !process.stdin.isTTY) {
+      const chunks = [];
+      for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+      }
+      prompt = Buffer.concat(chunks).toString("utf-8").trim();
+    }
+    if (!prompt) {
       process.stderr.write("Print mode (-p) requires a prompt argument.\n");
       process.exit(1);
     }
@@ -2459,19 +2489,13 @@ async function startCli() {
       sessionStore,
       sessionName: args.sessionName
     });
-    await new Promise((resolve, reject) => {
-      session.on("complete", (result) => {
-        process.stdout.write(result.response + "\n");
-        resolve();
-      });
-      session.on("interrupted", (result) => {
-        if (result.response) process.stdout.write(result.response + "\n");
-        resolve();
-      });
-      session.on("error", (err) => reject(err));
-      session.submit(prompt).catch(reject);
+    const transport = createHeadlessTransport({
+      outputFormat: args.outputFormat ?? "text",
+      prompt
     });
-    return;
+    session.attachTransport(transport);
+    await transport.start();
+    process.exit(transport.getExitCode());
   }
   renderApp({
     cwd,

package/dist/node/index.cjs

@@ -76,6 +76,9 @@ function parseCliArgs() {
       "max-turns": { type: "string" },
       "fork-session": { type: "boolean", default: false },
       name: { type: "string", short: "n" },
+      "output-format": { type: "string" },
+      "system-prompt": { type: "string" },
+      "append-system-prompt": { type: "string" },
       version: { type: "boolean", default: false },
       reset: { type: "boolean", default: false }
     }
@@ -91,6 +94,9 @@ function parseCliArgs() {
     maxTurns: parseMaxTurns(values["max-turns"]),
     forkSession: values["fork-session"] ?? false,
     sessionName: values["name"],
+    outputFormat: values["output-format"],
+    systemPrompt: values["system-prompt"],
+    appendSystemPrompt: values["append-system-prompt"],
     version: values["version"] ?? false,
     reset: values["reset"] ?? false
   };
@@ -170,6 +176,9 @@ function createProviderFromSettings(cwd, modelOverride) {
   }
 }
 
+// src/cli.ts
+var import_agent_transport_headless = require("@robota-sdk/agent-transport-headless");
+
 // src/ui/render.tsx
 var import_ink15 = require("ink");
 
@@ -934,9 +943,7 @@ function CjkTextInput({
   const pasteBufferRef = (0, import_react4.useRef)("");
   if (value !== valueRef.current) {
     valueRef.current = value;
-    if (cursorRef.current > value.length) {
-      cursorRef.current = value.length;
-    }
+    cursorRef.current = value.length;
   }
   (0, import_ink4.useInput)(
     (input, key) => {
@@ -1217,23 +1224,23 @@ function InputArea({
     const label = `[Pasted text #${id} +${lineCount} lines]`;
     setValue((prev) => prev ? `${prev} ${label}` : label);
   }, []);
-  const handleSubmit = (0, import_react6.useCallback)(
-    (text) => {
-      const trimmed = text.trim();
-      if (trimmed.length === 0) return;
-      if (showPopup && filteredCommands[selectedIndex]) {
-        selectCommand(filteredCommands[selectedIndex]);
+  const tabCompleteCommand = (0, import_react6.useCallback)(
+    (cmd) => {
+      const parsed = parseSlashInput(value);
+      if (parsed.parentCommand) {
+        setValue(`/${parsed.parentCommand} ${cmd.name} `);
         return;
       }
-      const expanded = expandPasteLabels(trimmed, pasteStore.current);
-      setValue("");
-      pasteStore.current.clear();
-      pasteIdRef.current = 0;
-      onSubmit(expanded);
+      if (cmd.subcommands && cmd.subcommands.length > 0) {
+        setValue(`/${cmd.name} `);
+        setSelectedIndex(0);
+        return;
+      }
+      setValue(`/${cmd.name} `);
     },
-    [showPopup, filteredCommands, selectedIndex, onSubmit]
+    [value, setSelectedIndex]
   );
-  const selectCommand = (0, import_react6.useCallback)(
+  const enterSelectCommand = (0, import_react6.useCallback)(
     (cmd) => {
       const parsed = parseSlashInput(value);
       if (parsed.parentCommand) {
@@ -1252,6 +1259,22 @@ function InputArea({
     },
     [value, onSubmit, setSelectedIndex]
   );
+  const handleSubmit = (0, import_react6.useCallback)(
+    (text) => {
+      const trimmed = text.trim();
+      if (trimmed.length === 0) return;
+      if (showPopup && filteredCommands[selectedIndex]) {
+        enterSelectCommand(filteredCommands[selectedIndex]);
+        return;
+      }
+      const expanded = expandPasteLabels(trimmed, pasteStore.current);
+      setValue("");
+      pasteStore.current.clear();
+      pasteIdRef.current = 0;
+      onSubmit(expanded);
+    },
+    [showPopup, filteredCommands, selectedIndex, onSubmit, enterSelectCommand]
+  );
   (0, import_ink7.useInput)(
     (_input, key) => {
       if (!showPopup) return;
@@ -1263,7 +1286,7 @@ function InputArea({
         setShowPopup(false);
       } else if (key.tab) {
         const cmd = filteredCommands[selectedIndex];
-        if (cmd) selectCommand(cmd);
+        if (cmd) tabCompleteCommand(cmd);
       }
     },
     { isActive: showPopup && !isDisabled }
@@ -2470,8 +2493,15 @@ async function startCli() {
     }
   }
   if (args.printMode) {
-    const prompt = args.positional.join(" ").trim();
-    if (prompt.length === 0) {
+    let prompt = args.positional.join(" ").trim();
+    if (!prompt && !process.stdin.isTTY) {
+      const chunks = [];
+      for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+      }
+      prompt = Buffer.concat(chunks).toString("utf-8").trim();
+    }
+    if (!prompt) {
       process.stderr.write("Print mode (-p) requires a prompt argument.\n");
       process.exit(1);
     }
@@ -2483,19 +2513,13 @@ async function startCli() {
       sessionStore,
       sessionName: args.sessionName
     });
-    await new Promise((resolve, reject) => {
-      session.on("complete", (result) => {
-        process.stdout.write(result.response + "\n");
-        resolve();
-      });
-      session.on("interrupted", (result) => {
-        if (result.response) process.stdout.write(result.response + "\n");
-        resolve();
-      });
-      session.on("error", (err) => reject(err));
-      session.submit(prompt).catch(reject);
+    const transport = (0, import_agent_transport_headless.createHeadlessTransport)({
+      outputFormat: args.outputFormat ?? "text",
+      prompt
     });
-    return;
+    session.attachTransport(transport);
+    await transport.start();
+    process.exit(transport.getExitCode());
   }
   renderApp({
     cwd,

package/dist/node/index.js

@@ -1,6 +1,6 @@
 import {
   startCli
-} from "./chunk-L5G6WFOL.js";
+} from "./chunk-74WEPZG2.js";
 export {
   startCli
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robota-sdk/agent-cli",
-  "version": "3.0.0-beta.46",
+  "version": "3.0.0-beta.47",
   "description": "AI coding assistant CLI built on Robota SDK",
   "type": "module",
   "bin": {
@@ -25,7 +25,7 @@
     "dist"
   ],
   "dependencies": {
-    "@robota-sdk/agent-sessions": "3.0.0-beta.46",
+    "@robota-sdk/agent-sessions": "3.0.0-beta.47",
     "chalk": "^5.3.0",
     "cli-highlight": "^2.1.0",
     "ink": "^6.8.0",
@@ -36,9 +36,10 @@
     "marked-terminal": "^7.3.0",
     "react": "19.2.4",
     "string-width": "^8.2.0",
-    "@robota-sdk/agent-core": "3.0.0-beta.46",
-    "@robota-sdk/agent-sdk": "3.0.0-beta.46",
-    "@robota-sdk/agent-provider-anthropic": "3.0.0-beta.46"
+    "@robota-sdk/agent-core": "3.0.0-beta.47",
+    "@robota-sdk/agent-sdk": "3.0.0-beta.47",
+    "@robota-sdk/agent-provider-anthropic": "3.0.0-beta.47",
+    "@robota-sdk/agent-transport-headless": "3.0.0-beta.47"
   },
   "devDependencies": {
     "@types/marked": "^6.0.0",