@mitsein-ai/cli 0.2.1 → 0.3.0

package/README.md

@@ -19,27 +19,23 @@ bun run src/index.ts --help
 ## Quick Start
 
 ```bash
+# Login
+mitsein auth login
+mitsein auth whoami
+
 # Check backend health
 mitsein dev health
 
-# Print dev token
-mitsein dev token
+# Create a thread, send a message, stream the agent run
+TID=$(mitsein --json thread create | jq -r .thread_id)
+mitsein agent invoke "$TID" "Hello" --stream
 
 # List threads
 mitsein thread list
 
-# Send a message and stream the agent run
-mitsein thread send <thread_id> "Hello" --stream
-
 # Auto-generated API commands from OpenAPI
 mitsein api list-tags
 mitsein api list-ops threads
-mitsein api threads list-threads
-
-# Login
-mitsein auth login
-mitsein auth login --device-code
-mitsein auth whoami
 ```
 
 ## Commands
@@ -55,17 +51,17 @@ mitsein auth whoami
 | `mitsein api <tag> <operation>` | Execute an API operation |
 | `mitsein thread list` | List threads |
 | `mitsein thread get <id>` | Get thread details |
-| `mitsein thread create` | Create a new thread |
+| `mitsein thread create [--name] [--agent]` | Create a new thread |
+| `mitsein thread rename <id> <name>` | Rename a thread |
+| `mitsein thread delete <id>` | Delete a thread |
 | `mitsein thread history <id>` | Show message history |
-| `mitsein thread send <id> <msg>` | Send message + start agent run |
-| `mitsein run list <thread_id>` | List agent runs |
-| `mitsein run get <run_id>` | Get run status |
-| `mitsein run tail <run_id>` | Stream events (like `tail -f`) |
-| `mitsein run wait <run_id>` | Block until run completes |
-| `mitsein run cancel <run_id>` | Cancel a running agent |
-| `mitsein messages list <id>` | List messages (no agent) |
-| `mitsein messages send <id> <msg>` | Add message (no agent) |
-| `mitsein agent invoke <id> <prompt>` | Message + agent start |
+| `mitsein agent invoke <id> <prompt>` | Send message + run agent (SSE) |
+| `mitsein agent running list` | List all active runs for the account |
+| `mitsein agent running status <tid>` | Read active-run state for a thread |
+| `mitsein agent running tail <tid>` | Reconnect to an in-progress run (`tail -f`) |
+| `mitsein agent running wait <tid>` | Block until the thread's run completes |
+| `mitsein agent running cancel <tid>` | Cancel a thread's running agent |
+| `mitsein files list/read/write/upload/mkdir/delete/download <tid>` | Sandbox file ops |
 | `mitsein project list` | List projects |
 | `mitsein project get <id>` | Get project details |
 | `mitsein project delete <id>` | Delete a project |
@@ -79,7 +75,7 @@ mitsein auth whoami
 |------|-------------|
 | `--endpoint <url>` | API base URL (default: `http://localhost:8000`) |
 | `--token <token>` | Bearer token |
-| `--profile <name>` | Profile name (default: `e2e`) |
+| `--profile <name>` | Profile name (default: `default`) |
 | `--real` | Use real account for dev token |
 | `--json` | Machine-readable JSON output |
 | `--debug` | Log HTTP details to stderr |
@@ -96,17 +92,39 @@ Same 4-step chain as the Python CLI:
 3. **OAuthProvider** — `~/.mitsein/oauth/<profile>.json`
 4. **DevTokenProvider** — `scripts/dev-token.sh` (localhost only)
 
-### Thread Send Modes
+### `agent invoke` Modes
+
+`agent invoke` always hits `POST /api/next/chat` which streams SSE. The three flags control how the client surfaces those events:
 
 ```bash
-# Fire-and-forget (default)
-mitsein thread send <id> "msg"
+# Default: wait silently, emit a structured result on exit
+mitsein agent invoke <tid> "msg"
+
+# Live streaming to stdout (human-readable or NDJSON with --json)
+mitsein agent invoke <tid> "msg" --stream
 
-# Wait for completion
-mitsein thread send <id> "msg" --wait
+# Event-type filter
+mitsein agent invoke <tid> "msg" --stream --filter tool_call,tool_result
 
-# Stream events in real-time
-mitsein thread send <id> "msg" --stream
+# Cancel the run on Ctrl-C (default is detach-only)
+mitsein agent invoke <tid> "msg" --stream --cancel-on-interrupt
+```
+
+Exit code: `0` on `done.reason == completed`, `1` on `error`, `124` on timeout, `130` on Ctrl-C.
+
+### Reconnect / Attach to a Running Agent
+
+Any client can attach to a thread's running agent and keep streaming from the last delivered event:
+
+```bash
+# Read status (includes last_event_id)
+mitsein agent running status <tid>
+
+# Resume from a specific event id
+mitsein agent running tail <tid> --since 1775915617543-0
+
+# Or block-wait until the run ends
+mitsein agent running wait <tid>
 ```
 
 ### OpenAPI Auto-Commands
@@ -114,10 +132,9 @@ mitsein thread send <id> "msg" --stream
 The `api` command dynamically generates subcommands from the backend's OpenAPI spec:
 
 ```bash
-mitsein api list-tags                    # See available tags
-mitsein api threads list-threads         # Auto-generated from spec
+mitsein api list-tags
+mitsein api list-ops threads
 mitsein api threads list-threads --body '{"limit": 10}'
-mitsein api threads list-threads --body @payload.json
 echo '{}' | mitsein api threads list-threads --body-stdin
 ```
 
@@ -125,18 +142,35 @@ echo '{}' | mitsein api threads list-threads --body-stdin
 
 ```bash
 bun run typecheck   # TypeScript check
-bun test            # Run tests (43 tests)
+bun test            # Run tests
 bun run build       # Build single binary
 ```
 
-## Migration Status
+## CHANGELOG
+
+### 0.3.0 (2026-04-11) — `/api/next` migration
+
+**Breaking changes** — CLI migrated from the deprecated `/api/thread/*` + `/api/message/*` + `/api/agent-run/*` routes to the unified `POST /api/next/chat` SSE endpoint.
+
+- **Removed**: `mitsein thread send` (was a duplicate of `agent invoke`)
+- **Removed**: `mitsein messages` command group entirely (backend no longer has a "add message without run" action; `messages list` duplicated `thread history`)
+- **Added**: `mitsein thread rename` (`PATCH /api/next/threads/{id}`), `mitsein thread delete`
+- **Changed**: `mitsein agent running {list,status,tail,wait,cancel}` now take `<thread_id>` instead of `<run_id>` — the backend no longer exposes per-run endpoints; a thread has at most one active run at a time
+- **Changed**: `mitsein agent running list` is now account-level (lists all active runs, not per-thread)
+- **Added**: `--since <event_id>` on `running tail` and `running wait` for precise reconnect
+- **Internal**: removed `core/sse.ts` + `core/waiters.ts`; replaced by `core/chat-stream.ts` (SSE reader with event-id support) + `core/chat-run.ts` (stream consumer with filter/accumulator) + `core/chat-output.ts` (human/NDJSON formatter)
+
+### 0.2.3 (2026-04-11)
+
+- Fix: unify profile default from `e2e` → `default` (`auth login` wrote `default.json` but other commands read `e2e.json`, causing "No credentials found" immediately after login)
+- Fix: `thread list/get/history` + `messages list` + `project list` migrated to working routes
+- Fix: `printDictHuman` no longer renders nested objects as `[object Object]`
+- Fix: `--debug` now logs method and URL correctly
+
+### 0.2.0 — 0.2.2
 
-| Phase | Content | Status |
-|-------|---------|--------|
-| P1 | Project skeleton + core layer | ✅ Done |
-| P2 | Extended core + API auto commands | ✅ Done |
-| P3 | Thread + run + messages commands | ✅ Done |
-| P4 | Agent + project + auth commands | ✅ Done |
-| P5 | npm publish + docs | ✅ Done |
+- P5 files command group
+- Auth: browser login, device code, whoami
+- Initial Python → TS port (0.1.0)
 
 RFC: [II95V6](https://gitee.com/mitsein/mitsein/issues/II95V6)