@shardflux/cli 0.6.0 → 0.6.1

package/CHANGELOG.md

@@ -3,7 +3,19 @@
 Every command and option the README shows is available from the version named here. Below 1.0, a minor release may
 break compatibility; breaking changes are marked **Breaking**.
 
-## 0.6.0 (not yet published)
+## 0.6.1
+
+Needs `@shardflux/sdk` 0.11.0 or later.
+
+### `--when-idle 0`: suspend as soon as the workspace is idle
+
+`shard ws suspend <id|key> --when-idle` accepts `0` (also `0s`) up to `1h`; before it refused anything under `30s`.
+The API now takes `after_seconds` from 0: the workspace is suspended as soon as it is idle (a few seconds of activity
+flush grace after its last work), and a running command, an attached stream or a keepalive still postpones it until
+it ends. The human output says `is suspended as soon as it is idle`, and `ws get` shows `as soon as idle`. Out of
+range is still exit 2 before any request: `--when-idle must be between 0s and 1h`.
+
+## 0.6.0
 
 Needs `@shardflux/sdk` 0.11.0 or later.
 

package/README.md

@@ -385,7 +385,7 @@ shows the status; `shard version --check` asks now (`--json`: `{"cli", "sdk", "u
 | `files search <id\|key> <path> <pattern> [--regex] [-i\|--ignore-case] [--include G]... [--exclude G]... [--max N]` | Search file contents under a directory (or in one file; gitignore-style globs): `path:line:column: text` per match (0.5.0+). |
 | `files patch <id\|key> <path> (--old T --new T)... [--replace-all] \| --content-file F\|- [--expected-revision R] [--if-revision N]` | Replace exact text (each `--old` must occur once unless `--replace-all`), or the whole content, atomically; `R` is a revision from `files stat --revision` or `absent` (0.5.0+). `--if-revision` (0.5.0+): file-first workspaces only. |
 | `workspaces suspend\|resume <id\|key> [--wait] [--timeout T] [--timing]` | Lifecycle operation. Returns immediately unless you pass `--wait`. |
-| `workspaces suspend <id\|key> --when-idle D` / `--cancel-when-idle` | (0.5.1+) Suspend once the workspace has been idle for `D` (30s to 1h), or cancel that. See "Suspend when idle". |
+| `workspaces suspend <id\|key> --when-idle D` / `--cancel-when-idle` | (0.5.1+) Suspend once the workspace has been idle for `D` (0 to 1h; `0` = as soon as it is idle, 0.6.1+), or cancel that. See "Suspend when idle". |
 | `workspaces fork <id\|key> <new-key> [caps] [--wait]` | Fork into a new key. |
 | `workspaces delete <id\|key> --yes [--wait]` | Delete the workspace. Tool access ends at once. The key of a persistent workspace is never reused. |
 | `workspaces close <id\|key> [--wait]` | End a session workspace now: it is deleted, and the key then opens a new workspace. A persistent workspace is refused (`not_session`). |
@@ -597,11 +597,13 @@ A running workspace is billed while it is awake. When an agent's turn ends, ask
 been idle for a short time, instead of waiting for its idle policy:
 
 ```sh
-shard ws suspend acme/demo --when-idle 2m    # 30s to 1h; whole seconds
+shard ws suspend acme/demo --when-idle 2m    # 0 to 1h; whole seconds
 shard ws get acme/demo                       # "suspend when idle  after 120 s idle, not before ..."
 shard ws suspend acme/demo --cancel-when-idle
 ```
 
+- `--when-idle 0` (0.6.1+) suspends the workspace as soon as it is idle (a few seconds after its last work).
+
 - The idle time counts from the later of the workspace's last work and the request.
 - A command still running, an attached stream or a keepalive postpones the suspend until the duration after it ends.
 - The next tool call on the workspace (the next turn) or a resume cancels the request. Repeating replaces it.

package/dist/args.d.ts

@@ -1,4 +1,4 @@
-export declare const CLI_VERSION = "0.6.0";
+export declare const CLI_VERSION = "0.6.1";
 export interface OptionSpec {
     type: 'string' | 'boolean';
     short?: string;

package/dist/args.js

@@ -12,7 +12,7 @@
 import { parseArgs } from 'node:util';
 import { ACCOUNT_COMMANDS } from "./account-args.js";
 import { UsageError } from "./errors.js";
-export const CLI_VERSION = '0.6.0';
+export const CLI_VERSION = '0.6.1';
 export const GLOBAL_OPTIONS = {
     'api-url': { type: 'string', value: '<url>', description: 'API base URL (default $SHARDFLUX_API_URL, else https://api.shardflux.dev).' },
     json: { type: 'boolean', description: 'Print machine-readable JSON on stdout (errors as JSON on stderr).' },
@@ -274,7 +274,7 @@ const KEY_COMMANDS = [
         description: 'Without options the suspend is requested now. --when-idle (0.5.1+) defers it instead: the workspace is suspended once it has been idle for that long, counted from the later of its last work and the request, so call it when an agent turn ends. A command still running, an attached exec or terminal stream, or a keepalive postpones it; the next tool call (the next turn) or a resume cancels it. Repeating replaces the pending request. --cancel-when-idle cancels it.',
         positionals: [REF],
         options: {
-            'when-idle': { type: 'string', value: '<duration>', description: 'Suspend once the workspace has been idle this long (30s to 1h, e.g. 30s, 2m; 0.5.1+). Cannot be combined with --wait.' },
+            'when-idle': { type: 'string', value: '<duration>', description: 'Suspend once the workspace has been idle this long (0.5.1+; 0 to 1h, e.g. 0, 30s, 2m; 0 = as soon as it is idle, 0.6.1+). Cannot be combined with --wait.' },
             'cancel-when-idle': { type: 'boolean', description: 'Cancel a pending --when-idle request (0.5.1+; idempotent).' },
             ...WAIT,
         },

package/dist/commands.d.ts

@@ -70,7 +70,7 @@ export type Handler = (ctx: Ctx, values: Values, positionals: string[]) => Promi
 export declare const str: (v: Values[string]) => string | undefined;
 export declare const strs: (v: Values[string]) => string[];
 export declare function out(ctx: Ctx, human: string, machine: unknown): void;
-/** `--when-idle <duration>`: whole seconds from 30 to 3600 (the API's after_seconds bounds, contracts §20.6). */
+/** `--when-idle <duration>`: whole seconds from 0 (as soon as it is idle; 0.6.1) to 3600 (the API's after_seconds bounds, contracts §20.6). */
 export declare function whenIdleSeconds(text: string): number;
 export declare function waitTimeout(values: Values): number;
 /**

package/dist/commands.js

@@ -66,14 +66,16 @@ function caps(values) {
         c.disk_gib = parsePositiveInt(disk, 'disk-gib', 1_000_000);
     return Object.keys(c).length ? c : undefined;
 }
-/** `--when-idle <duration>`: whole seconds from 30 to 3600 (the API's after_seconds bounds, contracts §20.6). */
+/** `--when-idle <duration>`: whole seconds from 0 (as soon as it is idle; 0.6.1) to 3600 (the API's after_seconds bounds, contracts §20.6). */
 export function whenIdleSeconds(text) {
+    if (/^0+(?:\.0+)?(?:ms|s|m|h)?$/.test(text.trim()))
+        return 0;
     const ms = parseDuration(text, 'when-idle');
     if (ms % 1000 !== 0)
         throw new UsageError('--when-idle must be a whole number of seconds (e.g. 30s, 90s, 2m)');
     const s = ms / 1000;
-    if (s < 30 || s > 3600)
-        throw new UsageError(`--when-idle must be between 30s and 1h (got "${text}")`);
+    if (s > 3600)
+        throw new UsageError(`--when-idle must be between 0s and 1h (got "${text}")`);
     return s;
 }
 export function waitTimeout(values) {

package/dist/format.js

@@ -109,13 +109,13 @@ export function startupTail(s) {
 }
 /** A pending suspend-when-idle request in one line (0.5.1; contracts §20.6). */
 export function suspendRequestText(r) {
-    return `after ${r.after_seconds} s idle, not before ${time(r.not_before)} (requested ${time(r.requested_at)})`;
+    return `${r.after_seconds === 0 ? 'as soon as idle' : `after ${r.after_seconds} s idle`}, not before ${time(r.not_before)} (requested ${time(r.requested_at)})`;
 }
 /** `shard ws suspend --when-idle`: the recorded request, or the suspend already in progress. */
 export function suspendWhenIdleText(w, r) {
     if (r.suspend_request) {
         const s = r.suspend_request;
-        return (`Suspend when idle: ${w.key} (${w.id}) is suspended once it has been idle for ${s.after_seconds} s, not before ${time(s.not_before)}.\n` +
+        return (`Suspend when idle: ${w.key} (${w.id}) is suspended ${s.after_seconds === 0 ? 'as soon as it is idle' : `once it has been idle for ${s.after_seconds} s`}, not before ${time(s.not_before)}.\n` +
             'A running command, an attached stream or a keepalive postpones it; the next tool call or a resume cancels it.\n' +
             `cancel with: shard workspaces suspend ${w.key} --cancel-when-idle\n`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardflux/cli",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "type": "module",
   "description": "shard: the Shardflux command line. Create an account, sign in, set up keys and billing, then open, run commands in, move files to, suspend, resume and fork persistent agent workspaces.",
   "license": "Apache-2.0",