@duyquangnvx/agent-cli 0.2.1 → 0.4.0

package/CHANGELOG.md

@@ -4,6 +4,77 @@ What changed in each release of `@duyquangnvx/agent-cli` (the Runtime) and `@duy
 
 ## Unreleased
 
+## v0.4.0 (2026-10-19)
+
+### Added
+
+- The last field of a Command's `args` may be a `z.array(...)`, optionally wrapped in optional or default, which takes every remaining operand: `tool preview a b c` gives `dirs: ["a", "b", "c"]`. None gives an empty array for the schema to judge, or leaves an optional field out so its default applies. Each operand is coerced like a scalar arg of the element's type, and an issue on one names it and its position, as in `<values...> "x" (argument 3): ...`. Text help shows the field as `<name...>` (`[name...]` when optional), and `--help --json` gives it the array schema. `defineCommand` throws when an array field is not the last of `args`.
+- The ports factory receives `PortsBase`, the run's base context: `env`, `cwd`, `packageRoot`, `secret`, `spawn`, `files`, `clock` and `signal`, the same classified, cwd-resolved helpers a Command gets, so an adapter reads a secret or the package root as a Command does. Under `runCli` it sees the test's `env`, `cwd`, `clock`, `files` and `spawn`, and the `ports` option still replaces its result. It runs when a run first reads `ctx.ports`, at most once, and what it throws exits by its Exit class like a Command error; a run that never reads them, such as `doctor` or `update`, never calls it, and a `doctor` row that reads them reports the error as its problem. A factory written as `() => Ports` still type-checks; the type `PortsBase` is exported.
+- A write or destructive Command may declare `force: "<what it replaces>"`, which gives it the Standard flag `--force` with that sentence as the flag's description in help and help JSON. A Command gets `--force` from `outputs`, `force` or both; with `outputs`, `--force` still lifts `OUTPUT_EXISTS`, and `outputs` alone keeps the generic description. `ctx.force` is true only when the caller passed `--force` to a Command that has it, and `plan` sees it under `--dry-run` too. `defineCommand` throws when a read or serve Command declares `force`, or when the sentence is empty.
+- `ctx.files.read(path)` returns a file's bytes as a `Uint8Array`; `ctx.files.list(folder)` returns the names in a folder, sorted, never the Runtime's temp files; `ctx.files.remove(path)` removes a file or a folder with everything in it, and succeeds when the path does not exist; `ctx.files.mkdir(path, { exclusive? })` creates a folder and its missing parents, and with `exclusive: true` fails when the folder exists. Each resolves its path against `ctx.cwd` and fails as `write` does: `PERMISSION_DENIED` (exit 2, with the sandbox hint under a Coding agent), `DISK_FULL` (exit 2) or `NOT_FOUND` (exit 1), naming the path. The type `MkdirOptions` is exported.
+- The Runtime code `ALREADY_EXISTS` (exit 1), raised for EEXIST, such as an exclusive `mkdir` of an existing folder, naming the path, with a hint to pass another path or remove that one. `ALREADY_EXISTS`, `PERMISSION_DENIED`, `DISK_FULL` and `NOT_FOUND` are exported as constants, so a Command catches one with `error instanceof CliError && error.code === ALREADY_EXISTS`.
+
+### Changed
+
+- **Breaking:** `doctor` exits 0 when only its `install` or `registry` row is a problem (not a global install, a newer version on the registry, or the registry unreachable). Those rows still show `problem` with their fix, in text and `--json`, and the fix stays under `next`.
+- **Breaking:** the `Files` interface gains `read`, `list`, `remove` and `mkdir`, so every fake passed as `runCli`'s `files` option must implement them. The scaffolded template's fake and the skill's example implement them.
+- **Breaking:** `ctx.files.write` creates missing parent folders, so a write into a missing folder no longer fails with `NOT_FOUND`.
+- The agent-cli skill teaches every 0.4.0 feature: the ports factory reading `PortsBase`, array positionals, `force` with `ctx.force`, and `ctx.files`' `read`, `list`, `remove` and `mkdir` with a caught `ALREADY_EXISTS`. Its example `links` gains `bundle <folder> <ids...>`, which writes shortcut files into a new folder and replaces an existing one under `--force`, a `web` port that `links check` uses and whose factory reads `LINKS_TOKEN`, and reads `links.json` through `ctx.files`.
+
+### Fixed
+
+- Under a Coding agent, a `PERMISSION_DENIED` on a read (`ctx.files.read`, `list` or `exists`, an unreadable `.env`, a tool `ctx.spawn` cannot run) asks the user to allow reading the path in the sandbox, not to add it to the sandbox's write list.
+- A `$XDG_CONFIG_HOME/<cli>/.env` the Runtime cannot read makes `ctx.secret` fail with `PERMISSION_DENIED` (exit 2) naming the file, with the sandbox hint under an agent, instead of exit 70. A missing `.env` still means no secrets.
+
+## v0.3.0 (2026-10-19)
+
+### Added
+
+- Data a Command prints over 30,000 characters, returned or delivered before a failure, is written to `$TMPDIR/<cli>/<time>-<command>.txt` (`.json` under `--json`), `<time>` being ISO 8601 with dashes for colons (`2026-10-19T08-00-00.000Z`) so the name is valid on Windows, through `ctx.files`, and stdout carries the file, its size in bytes and its first 2,000 characters: `{ "file", "bytes", "preview" }` under `--json`, else `file:`, `bytes:` and `preview:` lines. Writing one first removes that folder's spill files older than 7 days. A List Command never spills; `--limit` sizes it.
+- A write or destructive Command may declare `outputs(plan)`, the files its Plan writes relative to `ctx.cwd`. It gets the Standard flag `--force`; without it, a run where any output exists refuses with `OUTPUT_EXISTS` (exit 1) after `plan` and before the cost, `--confirm` and `apply`, naming the existing outputs, with the command plus `--force` in the hint. Its `--dry-run` prints `outputs:` and one indented path per line after the Plan, and under `--json` adds `outputs` to the dry run's object (`{ "plan", "outputs" }`, with `cost` too when declared). `Files` gains `exists(path)`, which `ctx.files` resolves under `ctx.cwd`. `force` is a reserved option and arg name.
+- A write or destructive Command may declare `cost(plan)`, a sentence stating the price or `undefined` when the run is cheap. It gets the Standard flag `--yes`; a run whose cost is a sentence and that lacks `--yes` refuses with `NOT_CONFIRMED` (exit 2) before `--confirm` and `apply`, the sentence in the message and the command plus `--yes` in the hint. Its `--dry-run` prints `cost: <sentence>` after the Plan, and under `--json` prints `{ "plan", "cost" }`, `cost` null when cheap. `yes` is a reserved option and arg name.
+- `ctx.deliver(data)` records the data a Command has done so far; the last call wins. When the run then fails, hits a `ctx.deadline` or is interrupted, that data prints on stdout through the Command's `render` (or as JSON under `--json`, with `--fields` applied to a page) and the errors on stderr. A returned value replaces it.
+- The Effect `serve`, for a Command that keeps running, such as a preview server: its `start(input, ctx)` returns data, which prints at once, and the Command runs until `ctx.signal` aborts. Ctrl-C or SIGTERM then ends the run with exit 0, after any `runToEnd` step finishes. It gets `--json` and no other Effect-driven Standard flag. A signal before `start` returns is still `INTERRUPTED`.
+- `agentCli<Ports>()` returns `defineCommand` and `defineCli` typed so that `ctx.ports` is `Ports`; `defineCli` takes `ports: () => Ports`, required when `Ports` has keys, and `runCli`'s `ports` option replaces them in a test. `Ports` defaults to none.
+- `ctx.clock` (`now`, `sleep`), on which `ctx.deadline` and the grace period after an interrupt now run, and `runCli`'s `clock` option, which replaces it so a test runs them instantly.
+- `ctx.poll(check, { intervalMs })` calls `check` until it returns a value other than `undefined`, sleeping on `ctx.clock` between calls, and ends with the abort reason of `ctx.signal`: `INTERRUPTED`, or `DEADLINE_EXCEEDED` at the run deadline.
+- A Command may declare a run deadline, `deadline: { ms, resume(input) }`. At `ms` on `ctx.clock`, `ctx.signal` aborts and the run ends with `DEADLINE_EXCEEDED` (exit 75), whose hint is the command line `resume(input)` returns; the data last passed to `ctx.deliver` prints on stdout, and `runToEnd` steps still finish within the grace period. The type `RunDeadline` is exported.
+- `ctx.packageRoot`: the folder holding the CLI's `package.json`, found from the running bin through any link npm put on `PATH`, or from `cwd` when `runCli` has no `bin`, so a Command can read files its package ships.
+- The Error table: `defineCli({ errors })` declares each error code once with its Exit class (`caller`, `operator`, `source` or `wait`) and an optional Zod `details` schema; `defineErrors` keeps the table's types, and `cliError(errors, code, { message, hint, details, retryAt })` throws a code whose `details` fail type checking when they do not match its schema. `retryAt` (ISO 8601) is accepted only on a wait-class code. Under `--json` each error carries `details` and `retryAt` when present. `defineCli` throws when the table redeclares a Runtime code.
+- Root help ends with `Exit codes:`, listing the classes the CLI can produce, then `Examples:`, one per top-level Command with `doctor` last; `--help --json` at the root has `errors`, the table with each code's class and `details` JSON Schema.
+- `ctx.files.write(path, data)` writes a file under `ctx.cwd` atomically, through a temp file named with the pid and a rename; the first write to a folder in a run removes the temp files of writers no longer running. A failure fails the run naming the path: EACCES or EPERM with `PERMISSION_DENIED` (exit 2), whose hint, when an agent is detected, names `! <command line>` and allowing the path in the sandbox's write list, else the path's permissions; ENOSPC with `DISK_FULL` (exit 2); ENOENT with `NOT_FOUND` (exit 1). `runCli`'s `files` option replaces the file system in a test, and the type `Files` is exported.
+- `ctx.spawn(command, args?, { cwd?, env?, check? })` runs a child process in `ctx.cwd` with `ctx.env` and resolves to `{ stdout, stderr, exitCode }`. Interrupting the run kills the child, and the run ends only once it has exited. With `check: true`, a non-zero exit fails the run with `TOOL_FAILED` (exit 2), its message ending with the last 20 lines of the child's stderr. A program that is not found fails the run with `TOOL_MISSING` (exit 2) naming it; one that cannot start for EACCES or EPERM fails with `PERMISSION_DENIED`, as `ctx.files` does. `runCli`'s `spawn` option replaces the child processes in a test, and the types `Spawn`, `SpawnOptions` and `SpawnResult` are exported.
+- A Command may declare `tools: [{ name, install }]`, the programs it runs. Before `plan`, `run` or `start`, also under `--dry-run`, the Runtime looks each up on `PATH` from `ctx.env`, and any missing fail the run together with `TOOL_MISSING` (exit 2), the hint holding each one's `install`. `doctor` adds one row per distinct tool across all Commands, after the CLI's own rows, with `install` as its fix. The type `Tool` is exported.
+- `ctx.secret(name)` returns `{ value, origin }` from the env (`origin: { kind: "env" }`), else from `$XDG_CONFIG_HOME/<cli>/.env` (default `~/.config`, with `HOME` and `XDG_CONFIG_HOME` read from the run's env; `origin: { kind: "file", path }`); an empty env value counts as unset, and a name in neither gives `undefined`. The agent-cli skill's example has a `doctor` row that reports a secret's origin and never its value.
+- `defineCli({ project: { file, schema } })` declares the Project file: `ctx.project` is `{ root, settings }` for the nearest such file at or above `cwd`, its JSON parsed by `schema`, or `undefined` when there is none. A file that is not JSON or fails its schema fails the run with `PROJECT_INVALID` (exit 2) before the Command runs, naming the path and the issues. The built-ins never read it, so an invalid one never stops `doctor` or `update`: `doctor` gets a `project` row, after `node`, that names the file, says none was found, or reports an invalid one as a problem. `agentCli<Ports, Settings>()` types `ctx.project.settings`.
+- `DoctorCheck.deadlineMs` sets a row's own deadline in place of the default 10 s, and `DoctorCheck.advisory` makes a row whose problem shows, with its fix under `next`, but never fails `doctor`.
+- Under a Coding agent (`CLAUDECODE`, `CODEX_CI`, `CODEX_SANDBOX`, `GEMINI_CLI`, `CURSOR_AGENT` or `CI` set), a usage error's text stderr ends with the full help of the Command or group that was misused, so the agent corrects its call without a second `--help`. A person at a terminal and `--json` output are unchanged.
+- A Command may throw an `AggregateError` of errors to report every problem it found. Text stderr prints each error with its hint, `--json` lists them all in `{ errors: [...] }`, and the run exits with the first of 1, 2, 3, 75 that any of them has, or 70 when any is not a known `CliError`; delivered data still prints on stdout.
+- `FORCE_COLOR`, set and neither empty nor `0`, turns colour on even under a Coding agent or without a TTY. `NO_COLOR` still turns it off.
+
+### Changed
+
+- **Breaking:** a `CliError` whose code is missing from the CLI's Error table exits 70, as a bug, no longer 1, and prints as one: `internal error:` with its message, the hint to rerun under `<NAME>_DEBUG=1` in place of its own, and its stack trace under debug. The help of a single-Command CLI shows its examples last, after the exit codes. The Scaffolder's `STEP_FAILED` exits 2.
+- **Breaking:** `CliErrorDetails` is renamed `CliErrorFields` and `UsageErrorDetails` `UsageErrorFields`; `CliError` takes and exposes `details` and `retryAt`.
+- **Breaking:** the skill's example declares an Error table and throws through `cliError`, with `NOT_FOUND` renamed `LINK_NOT_FOUND`; the skill and the scaffolded template's `AGENTS.md` describe the Error table.
+- **Breaking:** `doctor` starts with a `build` row showing the `--version` line, and the CLI's own rows now come right after `node`: the order is `build`, `node`, `project` (when the CLI declares a Project file), the CLI's rows, `install`, `registry`, `skill`.
+- **Breaking:** the Cli field `build` requires `builtAt`, an ISO time, and `--version` of a stamped build prints `X.Y.Z (sha[+dirty]) built <iso>` then `changelog <package root>/CHANGELOG.md`. The scaffolded template's build stamps `builtAt`; a build without a stamp still prints the version alone. The Scaffolder's package ships `CHANGELOG.md`, so the line names a file that exists.
+- **Breaking:** exit codes follow the failure's Exit class, who must act ([ADR 0005](docs/adr/0005-exit-codes-say-who-must-act.md)): 1 the caller, 2 the operator, 3 the source, 75 nobody but time, 70 a bug, 130 or 143 an interrupt. A usage error exits 1, no longer 2. `DEADLINE_EXCEEDED` exits 75. `INTERRUPTED` exits 130 on SIGINT and 143 on SIGTERM, from the bin and from `runCli`, whose `signal` aborted with the reason `"SIGTERM"` gives 143. An error that is not a `CliError` (`INTERNAL`) exits 70. The built-ins' codes exit by class: `DOCTOR_PROBLEMS`, `NOT_GLOBAL_INSTALL`, `REGISTRY_UNREACHABLE`, `REGISTRY_AUTH`, `INSTALL_FAILED` and `NPM_FAILED` exit 2, `NO_LATEST` exits 3.
+- **Breaking:** under `--json`, stderr is `{ "errors": [{ "code", "message", "hint" }] }`, a list even for one error, in place of the single error object.
+- **Breaking:** `ctx.runToEnd(name, work)` takes the step's name first. When the run is interrupted or hits its run deadline during the step, stderr says `finishing <name>`. The built-in `update` names its install step `installing <package>@<version>`.
+- **Breaking:** the scaffolded template declares an Error table and a `greetings` port in `src/ports.ts` through `agentCli<Ports>()`, and adds a `card` Command that writes `<name>.txt` through `ctx.files`, declaring `outputs` and a `cost` for a language other than English; its test fakes the port and the files through `runCli`, and its `AGENTS.md` and skill cover outputs, cost and ports. `examples/notes` gains `summarize`, which sends the notes to a `summarizer` port and writes the summary to a file, with `outputs` and a `cost` above 5 notes.
+- Under `<NAME>_DEBUG=1`, an error's `cause` chain prints after its stack trace, each cause on a `caused by:` line, and in the `stack` field under `--json`.
+- The agent-cli skill teaches every 0.3.0 feature: Exit classes and the Error table, several errors, `ctx.deliver`, spilled output, `outputs` with `--force`, `cost` with `--yes`, run deadlines and named steps, ports, `ctx.files`, `ctx.spawn` with `tools`, `ctx.clock` and `ctx.poll`, secrets, the Project file, `ctx.packageRoot`, the `serve` Effect and doctor's `deadlineMs` and `advisory`. Its example `links` gains `archive` (a port polled on the clock, a cost, a run deadline, delivered data and an `AggregateError`), `export` (an output), `commit` (`git` as a tool), `serve`, a Project file and an advisory `doctor` row, and its tests fake the port, the clock, `files` and `spawn`.
+
+### Fixed
+
+- On Windows, the built-in `update` and the `doctor` rows that ask npm (`install`, `registry`) now reach npm; they failed with `NPM_FAILED` because npm was named in quotes, so `npm.cmd` looked for its script in the working directory.
+
+### Removed
+
+- **Breaking:** `retryable` is gone from `CliError`, `CliErrorDetails` and the `--json` error; the hint says whether running again helps.
+- **Breaking:** the exports `defineCommand` and `defineCli`: call `agentCli()` (or `agentCli<Ports>()`) and use the pair it returns. The scaffolded template, `examples/notes` and the agent-cli skill do.
+
 ## v0.2.1 (2026-10-19)
 
 ### Changed

package/dist/abort.d.ts

@@ -0,0 +1,2 @@
+/** Never resolves; rejects with the signal's reason once it aborts. */
+export declare function untilAborted(signal: AbortSignal): Promise<never>;

package/dist/abort.js

@@ -0,0 +1,11 @@
+/** Never resolves; rejects with the signal's reason once it aborts. */
+export function untilAborted(signal) {
+    return new Promise((_resolve, reject) => {
+        if (signal.aborted) {
+            reject(signal.reason);
+            return;
+        }
+        signal.addEventListener("abort", () => reject(signal.reason), { once: true });
+    });
+}
+//# sourceMappingURL=abort.js.map

package/dist/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,OAAO,IAAI,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;QACtC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/agent-cli.d.ts

@@ -0,0 +1,17 @@
+import { type Cli, type CommandTreeCli, type DefineCommand, type NoPorts, type SingleCommandCli } from "./define.js";
+type PortsFactory<Ports> = NoPorts extends Ports ? {
+    readonly ports?: CommandTreeCli<Ports>["ports"];
+} : {
+    readonly ports: NonNullable<CommandTreeCli<Ports>["ports"]>;
+};
+type CliDeclaration<Ports, Settings> = (Omit<CommandTreeCli<Ports, Settings>, "ports"> & PortsFactory<Ports>) | (Omit<SingleCommandCli<Ports, Settings>, "ports"> & PortsFactory<Ports>);
+export interface AgentCli<Ports, Settings> {
+    readonly defineCommand: DefineCommand<Ports, Settings>;
+    defineCli(cli: CliDeclaration<Ports, Settings>): Cli<Ports, Settings>;
+}
+/**
+ * Declares the CLI's ports and its Project file's settings once; the `defineCommand` and
+ * `defineCli` it returns type `ctx.ports` and `ctx.project`.
+ */
+export declare function agentCli<Ports = NoPorts, Settings = unknown>(): AgentCli<Ports, Settings>;
+export {};

package/dist/agent-cli.js

@@ -0,0 +1,28 @@
+import { builtInCommands } from "./built-ins.js";
+import { defineCommandFor, } from "./define.js";
+import { runtimeCodesIn } from "./exit-classes.js";
+function checkOwnCodes(cli) {
+    const redeclared = runtimeCodesIn(cli.errors ?? {});
+    if (redeclared.length > 0) {
+        throw new Error(`${cli.name} declares ${redeclared.join(", ")}, an error code the Runtime already declares`);
+    }
+}
+function defineCli(cli) {
+    checkOwnCodes(cli);
+    if (cli.commands === undefined)
+        return cli;
+    const { commands } = cli;
+    const taken = Object.keys(builtInCommands(cli, undefined)).filter((name) => commands[name] !== undefined);
+    if (taken.length > 0) {
+        throw new Error(`${cli.name} defines ${taken.join(", ")}, a built-in Command it cannot replace`);
+    }
+    return cli;
+}
+/**
+ * Declares the CLI's ports and its Project file's settings once; the `defineCommand` and
+ * `defineCli` it returns type `ctx.ports` and `ctx.project`.
+ */
+export function agentCli() {
+    return { defineCommand: defineCommandFor(), defineCli };
+}
+//# sourceMappingURL=agent-cli.js.map

package/dist/agent-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-cli.js","sourceRoot":"","sources":["../src/agent-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAIL,gBAAgB,GAGjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAgBnD,SAAS,aAAa,CAAkB,GAAyB;IAC/D,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACpD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,GAAG,GAAG,CAAC,IAAI,aAAa,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,8CAA8C,CAC5F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAkB,GAAyB;IAC3D,aAAa,CAAC,GAAG,CAAC,CAAC;IACnB,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAC3C,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAC/D,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,SAAS,CACvC,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,GAAG,GAAG,CAAC,IAAI,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,wCAAwC,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAmB,EAAE,SAAS,EAAE,CAAC;AAC3E,CAAC"}

package/dist/agent.d.ts

@@ -0,0 +1,4 @@
+import type { Env } from "./define.js";
+export declare const AGENT_VARIABLES: readonly ["CLAUDECODE", "CODEX_CI", "CODEX_SANDBOX", "GEMINI_CLI", "CURSOR_AGENT", "CI"];
+/** Whether a Coding agent, not a person, is running the Agent CLI. */
+export declare function isAgent(env: Env): boolean;

package/dist/agent.js

@@ -0,0 +1,14 @@
+// Some Coding agents run commands in a PTY, so a TTY alone doesn't mean a person is watching.
+export const AGENT_VARIABLES = [
+    "CLAUDECODE",
+    "CODEX_CI",
+    "CODEX_SANDBOX",
+    "GEMINI_CLI",
+    "CURSOR_AGENT",
+    "CI",
+];
+/** Whether a Coding agent, not a person, is running the Agent CLI. */
+export function isAgent(env) {
+    return AGENT_VARIABLES.some((name) => env[name] !== undefined);
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAEA,8FAA8F;AAC9F,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY;IACZ,UAAU;IACV,eAAe;IACf,YAAY;IACZ,cAAc;IACd,IAAI;CACI,CAAC;AAEX,sEAAsE;AACtE,MAAM,UAAU,OAAO,CAAC,GAAQ;IAC9B,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;AACjE,CAAC"}

package/dist/built-ins.d.ts

@@ -1,4 +1,3 @@
-import type { Cli, Commands, CommandTreeCli } from "./define.js";
+import type { Commands, CommandTreeCli } from "./define.js";
 /** The Commands the Runtime adds to a multi-Command CLI: `update` only when it declares an install. */
 export declare function builtInCommands(cli: CommandTreeCli, bin: string | undefined): Commands;
-export declare function defineCli(cli: Cli): Cli;

package/dist/built-ins.js

@@ -7,14 +7,4 @@ export function builtInCommands(cli, bin) {
         ...(cli.install === undefined ? {} : { update: updateCommand(cli, cli.install, bin) }),
     };
 }
-export function defineCli(cli) {
-    if (cli.commands === undefined)
-        return cli;
-    const { commands } = cli;
-    const taken = Object.keys(builtInCommands(cli, undefined)).filter((name) => commands[name] !== undefined);
-    if (taken.length > 0) {
-        throw new Error(`${cli.name} defines ${taken.join(", ")}, a built-in Command it cannot replace`);
-    }
-    return cli;
-}
 //# sourceMappingURL=built-ins.js.map

package/dist/built-ins.js.map

@@ -1 +1 @@
-{"version":3,"file":"built-ins.js","sourceRoot":"","sources":["../src/built-ins.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,uGAAuG;AACvG,MAAM,UAAU,eAAe,CAAC,GAAmB,EAAE,GAAuB;IAC1E,OAAO;QACL,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC;QAC/B,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;KACvF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAQ;IAChC,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAC3C,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAC/D,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,SAAS,CACvC,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,GAAG,GAAG,CAAC,IAAI,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,wCAAwC,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"built-ins.js","sourceRoot":"","sources":["../src/built-ins.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,uGAAuG;AACvG,MAAM,UAAU,eAAe,CAAC,GAAmB,EAAE,GAAuB;IAC1E,OAAO;QACL,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC;QAC/B,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;KACvF,CAAC;AACJ,CAAC"}

package/dist/clock.d.ts

@@ -0,0 +1,10 @@
+/** Time as the Runtime sees it; a test replaces it through `runCli` to run every wait instantly. */
+export interface Clock {
+    now(): number;
+    /** Resolves after `ms`, or rejects with the signal's reason once it aborts. */
+    sleep(ms: number, signal?: AbortSignal): Promise<void>;
+}
+export declare const realClock: Clock;
+/** Runs `then` once `ms` have passed on `clock`; aborting `cancel` drops it. */
+export declare function after(clock: Clock, ms: number, cancel: AbortSignal, then: () => void): void;
+export declare function poll<T>(clock: Clock, check: () => T | undefined | Promise<T | undefined>, intervalMs: number, signal: AbortSignal): Promise<T>;

package/dist/clock.js

@@ -0,0 +1,35 @@
+export const realClock = {
+    now: () => Date.now(),
+    sleep: (ms, signal) => new Promise((resolve, reject) => {
+        if (signal?.aborted === true) {
+            reject(signal.reason);
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal?.reason);
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener("abort", onAbort, { once: true });
+    }),
+};
+/** Runs `then` once `ms` have passed on `clock`; aborting `cancel` drops it. */
+export function after(clock, ms, cancel, then) {
+    clock.sleep(ms, cancel).then(then, (error) => {
+        if (!cancel.aborted)
+            throw error;
+    });
+}
+export async function poll(clock, check, intervalMs, signal) {
+    for (;;) {
+        signal.throwIfAborted();
+        const value = await check();
+        if (value !== undefined)
+            return value;
+        await clock.sleep(intervalMs, signal);
+    }
+}
+//# sourceMappingURL=clock.js.map

package/dist/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../src/clock.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,SAAS,GAAU;IAC9B,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IACrB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CACpB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC9B,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC;CACL,CAAC;AAEF,gFAAgF;AAChF,MAAM,UAAU,KAAK,CAAC,KAAY,EAAE,EAAU,EAAE,MAAmB,EAAE,IAAgB;IACnF,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAc,EAAE,EAAE;QACpD,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,KAAK,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,KAAY,EACZ,KAAmD,EACnD,UAAkB,EAClB,MAAmB;IAEnB,SAAS,CAAC;QACR,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,MAAM,KAAK,EAAE,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACtC,MAAM,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/command-spec.js

@@ -2,6 +2,17 @@ import { isCommand } from "./define.js";
 import { standardFlagsFor } from "./flags.js";
 import { argFields, optionFields } from "./input.js";
 import { listSpec } from "./list.js";
+import { hasPlan } from "./planned.js";
+function declaredOf(command) {
+    if (!hasPlan(command)) {
+        return { outputs: false, force: undefined, cost: false };
+    }
+    return {
+        outputs: command.outputs !== undefined,
+        force: command.force,
+        cost: command.cost !== undefined,
+    };
+}
 export function commandSpec(commandLine, command) {
     const list = command.rows === undefined ? undefined : listSpec(command.rows);
     return {
@@ -13,7 +24,7 @@ export function commandSpec(commandLine, command) {
         examples: command.examples,
         args: argFields(command.args),
         options: optionFields(command.options),
-        standardFlags: standardFlagsFor(command.effect, list),
+        standardFlags: standardFlagsFor(command.effect, declaredOf(command), list),
         list,
         output: list?.output ?? command.output,
     };

package/dist/command-spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-spec.js","sourceRoot":"","sources":["../src/command-spec.ts"],"names":[],"mappings":"AACA,OAAO,EAA6C,SAAS,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAqB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,SAAS,EAAmB,YAAY,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAiB,QAAQ,EAAE,MAAM,WAAW,CAAC;AA0BpD,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,OAAgB;IAC/D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,OAAO;QACL,IAAI,EAAE,SAAS;QACf,WAAW;QACX,OAAO;QACP,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;QAC7B,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC;QACtC,aAAa,EAAE,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QACrD,IAAI;QACJ,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,WAAmB,EAAE,QAAkB;IAC/D,OAAO;QACL,IAAI,EAAE,OAAO;QACb,WAAW;QACX,QAAQ,EAAE,MAAM,CAAC,WAAW,CAC1B,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,WAAW,IAAI,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAC5F;KACF,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,WAAmB,EAAE,IAAwB;IAC3D,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACzF,CAAC"}
+{"version":3,"file":"command-spec.js","sourceRoot":"","sources":["../src/command-spec.ts"],"names":[],"mappings":"AACA,OAAO,EAA6C,SAAS,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAoC,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,SAAS,EAAmB,YAAY,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAiB,QAAQ,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA0BvC,SAAS,UAAU,CAAC,OAAgB;IAClC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,SAAS;QACtC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,SAAS;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,OAAgB;IAC/D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,OAAO;QACL,IAAI,EAAE,SAAS;QACf,WAAW;QACX,OAAO;QACP,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;QAC7B,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC;QACtC,aAAa,EAAE,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;QAC1E,IAAI;QACJ,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,WAAmB,EAAE,QAAkB;IAC/D,OAAO;QACL,IAAI,EAAE,OAAO;QACb,WAAW;QACX,QAAQ,EAAE,MAAM,CAAC,WAAW,CAC1B,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,WAAW,IAAI,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAC5F;KACF,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,WAAmB,EAAE,IAAwB;IAC3D,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACzF,CAAC"}

package/dist/confirm.d.ts

@@ -1,4 +1,6 @@
 import { type Invocation } from "./invocation.js";
+export declare const CONFIRMATION_REQUIRED = "CONFIRMATION_REQUIRED";
+export declare const CONFIRMATION_MISMATCH = "CONFIRMATION_MISMATCH";
 export interface Confirmation {
     readonly invocation: Invocation;
     readonly commandLine: string;

package/dist/confirm.js

@@ -1,6 +1,8 @@
 import { UsageError } from "./errors.js";
 import { CONFIRM_FLAG } from "./flags.js";
 import { commandLineWith } from "./invocation.js";
+export const CONFIRMATION_REQUIRED = "CONFIRMATION_REQUIRED";
+export const CONFIRMATION_MISMATCH = "CONFIRMATION_MISMATCH";
 export function checkConfirmation({ invocation, commandLine, given }, expected) {
     if (given === expected) {
         return;
@@ -8,13 +10,13 @@ export function checkConfirmation({ invocation, commandLine, given }, expected)
     const hint = `to confirm, run \`${commandLineWith(invocation, CONFIRM_FLAG.flag, expected)}\``;
     if (given === undefined) {
         throw new UsageError({
-            code: "CONFIRMATION_REQUIRED",
+            code: CONFIRMATION_REQUIRED,
             message: `\`${commandLine}\` is destructive and needs ${CONFIRM_FLAG.flag}`,
             hint,
         });
     }
     throw new UsageError({
-        code: "CONFIRMATION_MISMATCH",
+        code: CONFIRMATION_MISMATCH,
         message: `${CONFIRM_FLAG.flag} ${JSON.stringify(given)} does not match the target of \`${commandLine}\``,
         hint,
     });

package/dist/confirm.js.map

@@ -1 +1 @@
-{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../src/confirm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAmB,MAAM,iBAAiB,CAAC;AAQnE,MAAM,UAAU,iBAAiB,CAC/B,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAgB,EAChD,QAAgB;IAEhB,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,qBAAqB,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;IAC/F,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAAC;YACnB,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,KAAK,WAAW,+BAA+B,YAAY,CAAC,IAAI,EAAE;YAC3E,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IACD,MAAM,IAAI,UAAU,CAAC;QACnB,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,GAAG,YAAY,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,mCAAmC,WAAW,IAAI;QACxG,IAAI;KACL,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../src/confirm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAmB,MAAM,iBAAiB,CAAC;AAEnE,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAC7D,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAQ7D,MAAM,UAAU,iBAAiB,CAC/B,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAgB,EAChD,QAAgB;IAEhB,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,qBAAqB,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;IAC/F,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAAC;YACnB,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,KAAK,WAAW,+BAA+B,YAAY,CAAC,IAAI,EAAE;YAC3E,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IACD,MAAM,IAAI,UAAU,CAAC;QACnB,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,GAAG,YAAY,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,mCAAmC,WAAW,IAAI;QACxG,IAAI;KACL,CAAC,CAAC;AACL,CAAC"}

package/dist/cost.d.ts

@@ -0,0 +1,9 @@
+import { type Invocation } from "./invocation.js";
+export declare const NOT_CONFIRMED = "NOT_CONFIRMED";
+export interface Approval {
+    readonly invocation: Invocation;
+    readonly commandLine: string;
+    readonly yes: boolean;
+}
+/** Refuses a run whose Plan states a cost the caller has not approved with `--yes`. */
+export declare function checkCost({ invocation, commandLine, yes }: Approval, cost: string | undefined): void;

package/dist/cost.js

@@ -0,0 +1,16 @@
+import { CliError } from "./errors.js";
+import { YES_FLAG } from "./flags.js";
+import { commandLineWith } from "./invocation.js";
+export const NOT_CONFIRMED = "NOT_CONFIRMED";
+/** Refuses a run whose Plan states a cost the caller has not approved with `--yes`. */
+export function checkCost({ invocation, commandLine, yes }, cost) {
+    if (cost === undefined || yes) {
+        return;
+    }
+    throw new CliError({
+        code: NOT_CONFIRMED,
+        message: `\`${commandLine}\` needs ${YES_FLAG.flag}: ${cost}`,
+        hint: `to approve the cost, run \`${commandLineWith(invocation, YES_FLAG.flag)}\``,
+    });
+}
+//# sourceMappingURL=cost.js.map

package/dist/cost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.js","sourceRoot":"","sources":["../src/cost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,eAAe,EAAmB,MAAM,iBAAiB,CAAC;AAEnE,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAQ7C,uFAAuF;AACvF,MAAM,UAAU,SAAS,CACvB,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,EAAY,EAC1C,IAAwB;IAExB,IAAI,IAAI,KAAK,SAAS,IAAI,GAAG,EAAE,CAAC;QAC9B,OAAO;IACT,CAAC;IACD,MAAM,IAAI,QAAQ,CAAC;QACjB,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,KAAK,WAAW,YAAY,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE;QAC7D,IAAI,EAAE,8BAA8B,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI;KACnF,CAAC,CAAC;AACL,CAAC"}