@keystrokehq/cli 0.1.95 → 0.1.96

package/dist/skills-bundle/_AGENTS.mcp.md

@@ -90,13 +90,16 @@ Use `exec_command` with the keystroke CLI — credentials are injected automatic
 keystroke workflows list                                                        # list deployed workflows
 keystroke workflows run <workflow-slug> --input '{}'                            # invoke a workflow
 keystroke workflows runs list <workflow-slug>                                   # recent runs for a workflow
-keystroke workflows runs get <workflow-slug> <run-id> --include steps,trace     # one run in full: input, each step, execution trace
+keystroke workflows runs get <workflow-slug> <run-id> --summary                 # lean status/input/output/error
+keystroke workflows runs get <workflow-slug> <run-id> --field output            # one field without jq
+keystroke workflows runs get <workflow-slug> <run-id> --include steps,trace     # full detail when needed
 
-# Agents
+# Agents (durable unit is a session, not a run)
 keystroke agents list                                                           # list deployed agents
 keystroke agents prompt <agent-slug> --message "Hi"                             # send a message (add --session-id to continue a session)
 keystroke agents sessions list <agent-slug>                                     # recent sessions for an agent
-keystroke agents sessions get <agent-slug> <session-id> --include messages,trace # one session in full: messages, execution trace
+keystroke agents sessions get <agent-slug> <session-id> --summary               # lean status/title/error
+keystroke agents sessions get <agent-slug> <session-id> --include messages,trace # full detail when needed
 
 # Triggers (attachment id is <trigger-slug>:<target-slug>; narrow with --workflow/--agent)
 keystroke triggers list                                                         # list deployed triggers

package/dist/skills-bundle/_AGENTS.md

@@ -288,13 +288,17 @@ Both materialize into the agent's `/workspace/agent/...` environment before each
 
 ## Audit & debug
 
-Inspect deployed runs with `--include` to see full traces:
+Inspect deployed runs progressively — start lean, then request richer detail only when needed:
 
 ```bash
 keystroke workflows runs list <workflow-slug>
+keystroke workflows runs get <workflow-slug> <run-id> --summary
+keystroke workflows runs get <workflow-slug> <run-id> --field output
 keystroke workflows runs get <workflow-slug> <run-id> --include steps,trace
 
 keystroke agents sessions list <agent-slug>
+keystroke agents sessions get <agent-slug> <session-id> --summary
+keystroke agents sessions get <agent-slug> <session-id> --field status
 keystroke agents sessions get <agent-slug> <session-id> --include messages,trace
 
 keystroke triggers list
@@ -306,7 +310,9 @@ keystroke triggers disable <trigger-slug>   # pause without redeploy; --workflow
 keystroke history list --kind workflow --status failed
 ```
 
-Invoke/inspect commands print JSON to stdout (exit 0 on success, 1 on failure) — pipe to `jq`. Lifecycle commands (`init`/`dev`/`deploy`) print human status.
+Workflows have durable **runs**; agents have durable **sessions** (use `agents sessions get`, not `agents runs get`).
+
+Invoke/inspect commands print JSON to stdout (exit 0 on success, 1 on failure) — pipe to `jq` when you need arbitrary paths. Prefer `--summary` / `--field` for common inspection so you don't dig through nested envelopes. Lifecycle commands (`init`/`dev`/`deploy`) print human status.
 
 ## Before you claim you're done
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keystrokehq/cli",
-  "version": "0.1.95",
+  "version": "0.1.96",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/keystrokehq/keystroke.git",