@tuttiai/cli 0.8.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -37,6 +37,66 @@ Features:
37
37
  - Session continuity across messages
38
38
  - Graceful Ctrl+C handling
39
39
 
40
+ ### `tutti-ai resume <session-id>`
41
+
42
+ Resume a crashed or interrupted run from its last durable checkpoint.
43
+ Requires the agent to have been configured with `durable: true` on the
44
+ original run, and a Redis or Postgres backend reachable via the matching
45
+ env var.
46
+
47
+ ```bash
48
+ # Redis-backed checkpoint
49
+ export TUTTI_REDIS_URL=redis://127.0.0.1:6379/0
50
+ tutti-ai resume 811b3b38-9a1d-4b98-ab7d-57e4acaecdea --store redis
51
+
52
+ # Postgres-backed checkpoint
53
+ export TUTTI_PG_URL=postgres://localhost/tutti
54
+ tutti-ai resume 811b3b38-9a1d-4b98-ab7d-57e4acaecdea --store postgres
55
+ ```
56
+
57
+ Options:
58
+
59
+ | Flag | Default | What it does |
60
+ |---|---|---|
61
+ | `--store <backend>` | `redis` | Which durable store the checkpoint was written to (`redis` or `postgres`). |
62
+ | `-s, --score <path>` | `./tutti.score.ts` | Score file to load — must match the one the original run used. |
63
+ | `-a, --agent <name>` | `score.entry` or the first agent | Which agent to resume. |
64
+ | `-y, --yes` | false | Skip the confirmation prompt (useful for scripts). |
65
+
66
+ The command prints a summary (last completed turn, timestamp, first few
67
+ messages) and asks `Resume from turn N? (y/n)` before handing off. On
68
+ confirm it loads the score, reattaches the checkpoint store, seeds the
69
+ session, and calls the runtime — picking up exactly where the previous
70
+ run left off. Saying `n` exits without running anything.
71
+
72
+ Typical flow after a crash:
73
+
74
+ ```bash
75
+ $ tutti-ai run ./my-score.ts
76
+ > research recent AI papers
77
+ · Checkpoint saved at turn 1
78
+ · Checkpoint saved at turn 2
79
+ [process crashes / SIGKILL]
80
+
81
+ $ tutti-ai resume 811b3b38-9a1d-4b98-ab7d-57e4acaecdea --store redis
82
+
83
+ Checkpoint summary
84
+ Session ID: 811b3b38-9a1d-4b98-ab7d-57e4acaecdea
85
+ Last turn: 2
86
+ Saved at: 2026-04-13T15:47:12.031Z
87
+ Messages: 5 total
88
+
89
+ First messages
90
+ [user] research recent AI papers
91
+ [assistant] [tool_use search_web]
92
+ [user] [tool_result {"results":[…]}]
93
+
94
+ Resume from turn 2? (y/n) y
95
+ ↻ Restored from turn 2 (session 811b3b38…)
96
+ ✓ Resumed run complete.
97
+ Final turn: 3
98
+ ```
99
+
40
100
  ## Links
41
101
 
42
102
  - [Tutti](https://tutti-ai.com)