@saga-ai/cli 0.7.0 → 0.7.1

package/README.md

@@ -16,6 +16,7 @@ npx @saga-ai/cli init
 npx @saga-ai/cli find <query>
 npx @saga-ai/cli worktree <epic-slug> <story-slug>
 npx @saga-ai/cli implement <story-slug>
+npx @saga-ai/cli sessions list
 npx @saga-ai/cli dashboard
 ```
 
@@ -49,6 +50,7 @@ saga find auth --type epic
 
 Options:
 - `--type <type>` - Type to search for: `epic` or `story` (default: story)
+- `--status <status>` - Filter stories by status: `ready`, `completed`, `blocked`, etc.
 
 Returns JSON with:
 - `found: true` + `data` - Single match found
@@ -83,15 +85,37 @@ saga implement my-story
 saga implement my-story --max-cycles 5
 saga implement my-story --max-time 30
 saga implement my-story --model sonnet
+saga implement my-story --attached --stream
 ```
 
 Options:
 - `--max-cycles <n>` - Maximum number of worker cycles (default: 10)
 - `--max-time <n>` - Maximum time in minutes (default: 60)
 - `--model <name>` - Model to use (default: opus)
+- `--attached` - Run in attached mode (synchronous). Default is detached (runs in tmux session)
+- `--stream` - Stream worker output to stdout (only works with `--attached`)
+
+By default, `implement` runs in **detached mode** using a tmux session. This allows the worker to continue running even if your terminal disconnects. Use `saga sessions` to monitor detached sessions.
 
 **Note:** Requires `SAGA_PLUGIN_ROOT` environment variable to be set. This is automatically configured when running via the SAGA plugin.
 
+### `saga sessions`
+
+Manage tmux sessions created by detached `implement` runs.
+
+```bash
+saga sessions list              # List all SAGA sessions
+saga sessions status <name>     # Check if session is running
+saga sessions logs <name>       # Stream session output
+saga sessions kill <name>       # Terminate a session
+```
+
+Subcommands:
+- `list` - Returns JSON array of all SAGA sessions with name, status, and output file
+- `status <name>` - Returns JSON `{running: boolean}` for the session
+- `logs <name>` - Streams the session output file via `tail -f`
+- `kill <name>` - Terminates the session, returns JSON `{killed: boolean}`
+
 ### `saga dashboard`
 
 Start the SAGA dashboard server for viewing epics, stories, and progress.

package/dist/cli.cjs

@@ -1042,6 +1042,22 @@ function formatStreamLine(line) {
     return null;
   }
 }
+function extractStructuredOutputFromToolCall(lines) {
+  for (let i = lines.length - 1; i >= 0; i--) {
+    try {
+      const data = JSON.parse(lines[i]);
+      if (data.type === "assistant" && data.message?.content) {
+        for (const block of data.message.content) {
+          if (block.type === "tool_use" && block.name === "StructuredOutput") {
+            return block.input;
+          }
+        }
+      }
+    } catch {
+    }
+  }
+  return null;
+}
 function parseStreamingResult(buffer) {
   const lines = buffer.split("\n").filter((line) => line.trim());
   for (let i = lines.length - 1; i >= 0; i--) {
@@ -1051,10 +1067,13 @@ function parseStreamingResult(buffer) {
         if (data.is_error) {
           throw new Error(`Worker failed: ${data.result || "Unknown error"}`);
         }
-        if (!data.structured_output) {
+        let output = data.structured_output;
+        if (!output) {
+          output = extractStructuredOutputFromToolCall(lines);
+        }
+        if (!output) {
           throw new Error("Worker result missing structured_output");
         }
-        const output = data.structured_output;
         if (!VALID_STATUSES.has(output.status)) {
           throw new Error(`Invalid status: ${output.status}`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saga-ai/cli",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "CLI for SAGA - Structured Autonomous Goal Achievement",
   "type": "module",
   "bin": {