@robota-sdk/agent-cli 3.0.0-beta.45 → 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:
@@ -181,6 +204,34 @@ After the Edit tool runs, a `DiffBlock` component renders the change inline:
 
 Removed lines appear in red with `-`, added lines in green with `+`. Diffs longer than 10 lines show the first 8 + a `... and N more lines` summary.
 
+## Session Management
+
+The CLI supports continuing, resuming, forking, and naming sessions.
+
+### CLI Flags
+
+| Flag                  | Description                                      |
+| --------------------- | ------------------------------------------------ |
+| `-c`, `--continue`    | Continue the most recent session                 |
+| `-r`, `--resume <id>` | Resume a specific session by ID                  |
+| `--fork-session <id>` | Fork a session (new session with copied history) |
+| `--name <name>`       | Assign a name to the session at startup          |
+
+### TUI Commands
+
+| Command          | Description                         |
+| ---------------- | ----------------------------------- |
+| `/resume`        | List recent sessions and resume one |
+| `/rename <name>` | Rename the current session          |
+
+### Session Name Display
+
+When a session has a name, it appears in three places:
+
+- **Input border** — session name shown in the input area border
+- **Terminal title** — updated via ANSI escape sequences
+- **StatusBar** — displayed alongside mode, model, and context usage
+
 ## Slash Commands
 
 | Command                   | Description                                                |
@@ -195,9 +246,11 @@ Removed lines appear in red with `-`, added lines in green with `+`. Diffs longe
 | `/context`                | Context window details                                     |
 | `/permissions`            | Show permission rules                                      |
 | `/plugin [subcommand]`    | Plugin management TUI                                      |
+| `/resume`                 | List recent sessions and resume one                        |
+| `/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
 
@@ -287,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-Y6VSMUKG.js";
+} from "./chunk-74WEPZG2.js";
 
 // src/bin.ts
 process.on("uncaughtException", (err) => {