@nanobpm/nano-coder 0.51.1 → 0.52.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.
Files changed (2) hide show
  1. package/README.md +31 -1
  2. package/package.json +5 -5
package/README.md CHANGED
@@ -413,6 +413,7 @@ argument: a type-ahead list narrows as you type and Tab completes it.
413
413
  - `/tools` - List registered tools
414
414
  - `/skills` - List the skills the agent can load, where each lives, and any loading warnings
415
415
  - `/plan` - Show the agent's task plan with all notes
416
+ - `/timers` - List the session's timers (the agent schedules them with `timer_set` to come back to you later); shows each timer's id, due time and note (see [Timers](#timers))
416
417
  - `/memory [forget ID]` - List cross-session memories with their ids, or delete one by id (see [Memory](#memory))
417
418
  - `/hooks` - List the loaded external user hooks (from `.claude/settings.json` and friends), the files they came from, and any skipped entries (see [Lifecycle Hooks](#lifecycle-hooks))
418
419
  - `/queue [list|add text|remove N...|edit N text|clear]` - Show or edit the queued messages and unread steers. Works while a turn runs, so a queued message or steer can be removed or rewritten before it is sent.
@@ -470,7 +471,12 @@ asks again on the session's next turn.
470
471
 
471
472
  Flags: `--login github-copilot|muse`, `--list-models PROVIDER`, `--trajectory SESSION_ID [--json|--markdown]`, `--acp`, `--model provider/model` (or `AGENTIC_HARNESS_MODEL`), `--resume [SESSION_ID|last]`, `--list-sessions [--all] [--json]`,
472
473
  `--config PATH`, `--verbosity LEVEL` (`-v`), `--sandbox off|workspace|read-only` (or `NANO_CODER_SANDBOX`),
473
- `--allow RULE` and `--deny RULE` (repeatable; added to the config's rules), `--version` (`-V`).
474
+ `--allow RULE` and `--deny RULE` (repeatable; added to the config's rules), `--wait-timers`, `--version` (`-V`).
475
+
476
+ `--wait-timers` keeps the session alive for scheduled timers (see [Timers](#timers)) after input ends.
477
+ In an interactive session the agent already waits at the prompt, but a piped or redirected run exits
478
+ once stdin closes — so a run that reads its prompt from a pipe needs `--wait-timers` to keep waiting
479
+ for timers set during the turn to come due, fire, and be delivered. Ctrl-C exits the wait.
474
480
 
475
481
  Before opening a PR, run `cargo fmt` (style in `rustfmt.toml`), `cargo clippy --all-targets -- -D warnings`
476
482
  and `cargo test`; CI checks all three. To keep `git blame` past the one-time reformat, run
@@ -1140,6 +1146,30 @@ the result:
1140
1146
 
1141
1147
  Plan and outcome calls don't count. Set `reminders = false` to turn them off.
1142
1148
 
1149
+ ## Timers
1150
+
1151
+ The `timer_*` tools let the agent schedule a note to itself to come back to you later — for
1152
+ example to check on a long build, or to follow up after a delay. A timer lives only for the
1153
+ session (it is written to the session log, so `--resume` restores pending ones).
1154
+
1155
+ - `timer_set` - schedule a timer. Give exactly one of `after` (a delay like `30m`, `1h30m`,
1156
+ `90s`, `2 hours`, `1.5h`) or `at` (a time like `HH:MM` for the next occurrence, or an ISO
1157
+ date-time such as `2026-10-25T14:30`, local unless you append an offset like `+02:00` or `Z`),
1158
+ plus a `note` describing what to do when it fires. Up to 10 timers can be active at once.
1159
+ - `timer_list` - the session's timers with their ids, due times and notes.
1160
+ - `timer_cancel` - drop a timer by `id`.
1161
+ - `timer_done` - acknowledge a fired timer by `id` once it is handled.
1162
+
1163
+ When a timer comes due it is delivered to the model as an automatic turn. If one fires while a
1164
+ turn is already running it is delivered mid-turn; otherwise it starts a fresh automatic turn
1165
+ when the session is idle. `/timers` shows the current timers in the terminal.
1166
+
1167
+ In an interactive session the agent waits at the prompt, so due timers fire naturally. A piped
1168
+ or redirected (non-interactive) run, however, exits as soon as stdin closes — pass
1169
+ `--wait-timers` to keep such a run alive after input ends so timers set during the turn can come
1170
+ due, fire and be delivered; Ctrl-C exits the wait. The timer tools are available in interactive
1171
+ CLI sessions; ACP headless mode has no idle loop to fire them, so they are not offered there.
1172
+
1143
1173
  ## Outcomes
1144
1174
 
1145
1175
  `report_outcome` is the model's explicit end-of-task signal: `status` is `completed` (the
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nanobpm/nano-coder",
3
- "version": "0.51.1",
3
+ "version": "0.52.0",
4
4
  "description": "A 6MB coding agent. Run a fleet on your laptop.",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -27,9 +27,9 @@
27
27
  "node": ">=18"
28
28
  },
29
29
  "optionalDependencies": {
30
- "@nanobpm/nano-coder-darwin-arm64": "0.51.1",
31
- "@nanobpm/nano-coder-darwin-x64": "0.51.1",
32
- "@nanobpm/nano-coder-linux-arm64": "0.51.1",
33
- "@nanobpm/nano-coder-linux-x64": "0.51.1"
30
+ "@nanobpm/nano-coder-darwin-arm64": "0.52.0",
31
+ "@nanobpm/nano-coder-darwin-x64": "0.52.0",
32
+ "@nanobpm/nano-coder-linux-arm64": "0.52.0",
33
+ "@nanobpm/nano-coder-linux-x64": "0.52.0"
34
34
  }
35
35
  }