@cleanslop/cli 0.1.0-beta.0 → 0.1.0-beta.10

package/README.md

@@ -1,6 +1,6 @@
 # cleanslop CLI (M4)
 
-Private-beta CLI for agentic CleanSlop, published as `@cleanslop/cli` (bin `cleanslop`). Beta builds go out under the `beta` dist-tag from `.github/workflows/cli-beta.yml`; do not `npm publish` by hand except the one-time first publish in `docs/ops/agent-beta.md` (CLI beta).
+Private-beta CLI for agentic CleanSlop, published as `@cleanslop/cli` (bin `cleanslop`). Beta builds go out under the `beta` dist-tag from `.github/workflows/cli-beta.yml`, and releases under `latest` from `.github/workflows/cli-release.yml` on every `master` change to `cli/` (versions from `scripts/release-version.mjs`); do not `npm publish` by hand except the one-time first publish in `docs/ops/agent-beta.md` (CLI beta).
 
 ## Install / run
 
@@ -35,6 +35,7 @@ The app TypeScript / ESLint / coverage gates exclude `cli/` (`tsconfig.json`, `t
 | `status [id] [--wait]` | Poll scan status |
 | `report [id] [--format md\|json] [--preview]` | Fetch `cleanslop.report.v1` |
 | `setup` | Idempotent skill/rules. Never logs in, never writes a token |
+| `redeem <code>` | Redeem a promo (invite) code the human gave you for free scans (`POST /api/agent/v1/credits/redeem`). One code per account; `promo_invalid` / `promo_already_redeemed` exit 12 with an `ask_human` block. |
 
 ### Wait
 
@@ -80,7 +81,7 @@ Skill / Cursor rules / AGENTS snippet are generated from [`assets/skill-core.md`
 | 20 | Scan failed server-side |
 | 75 | Still running; resume command printed |
 
-`CLEANSLOP_ACTION_REQUIRED` blocks go to stderr. Never open, approve, or pay.
+`CLEANSLOP_ACTION_REQUIRED` blocks go to stderr. Never open, approve, or pay. A block may end with a `CLEANSLOP_QUESTION:` JSON line (`id`, `header`, `question`, `options[]` with `value`, `label`, optional `description`, and `run` for the exact next command or `next` for a plain next step; neither means stop). Agents with a multiple-choice question tool (for example Claude Code's AskUserQuestion) should ask with it, using exactly those options, and never answer for the human. Consent questions never carry `--agree`.
 
 ## Tests
 

package/assets/skill-core.md

@@ -14,16 +14,27 @@ Use MCP if it is registered (`<origin>/mcp`); otherwise the CLI. Run it as `npx
 
 Run Link and login commands in the foreground with `--no-wait`. When one prints an `approve` block, relay the link and code, wait for the human to approve, then rerun the same command with `--resume` instead of `--no-wait`.
 
-1. Run `cleanslop login --link --no-wait`. The first run stops with an `ask_human` block quoting the terms and the email-sharing question. Relay both **exactly as printed**.
-2. If the human says yes to both, rerun with `--accept-terms --yes-share-email --no-wait`. If not, stop.
+1. Run `cleanslop login --link --no-wait`. The first run stops with an `ask_human` block quoting one question (an account from the Link-verified email, plus the terms). Relay it **exactly as printed**.
+2. If the human says yes, rerun with `--agree --no-wait`. If not, stop.
 3. If Link is not signed in on this machine, the CLI prints an `approve` block with a Link link and a phrase and exits 10. Relay them; after the human approves in the Link app, rerun with `--resume` instead of `--no-wait`.
 4. On success it prints “Connected as <masked email> (Link)”. Repeat that to the human.
-5. `link_existing` means the Link email already belongs to a CleanSlop account. Run `cleanslop login --no-wait` (GitHub device login), then `cleanslop link-identity --no-wait`, each with the approve-then-`--resume` step above. `link-identity` asks its own email-sharing question (`--yes-share-email` after a yes).
+5. `link_existing` means the Link email already belongs to a CleanSlop account. Run `cleanslop login --no-wait` (GitHub device login), then `cleanslop link-identity --no-wait`, each with the approve-then-`--resume` step above. `link-identity` asks its own email question (`--agree` after a yes).
 6. `beta` means this Link email is not in the pilot yet. Tell the human and stop.
 
+## Buy credits with Link
+
+Run purchase commands in the foreground with `--no-wait`, the same way as Link sign-in. The human approves every payment in their Link app; never approve or pay yourself.
+
+1. When a scan exits 11 with a `top-up` block, or `credits buy` without `--pack` asks which pack, ask the human to choose (the block lists each pack's scans, price, and price per scan). If they choose not to buy, stop. Never pick a pack for them.
+2. Run `cleanslop credits buy --link --pack <pack> --no-wait` with their pack. It prints an `approve` block and exits 10. Relay its prompt: Link sends the approval to the human's Link app, and there is usually no link to open.
+3. After the human approves in the Link app, run `cleanslop credits buy --link --resume`. If it prints `approve` again, they have not approved yet: relay the prompt again and wait. If it prints `ask_human`, relay it and follow it. Never start a second purchase while one is pending.
+4. On success it prints “Added … scan credits. Balance: N”. Rerun the scan.
+5. If the CLI says Link packs are not available or to contact us for credits, tell the human and stop. For a GitHub account, the `top-up` block is a checkout link instead: relay it and wait.
+6. Promo codes: if the human gives you a CleanSlop promo code, run `cleanslop redeem <code>` (MCP: `promo_redeem`). Use only a code the human typed in this session; never guess, search for, or reuse one. Each account can use one code; if the CLI says the code is not valid or already used, tell the human and stop. When the account is out of scans and has not used a code yet, the out-of-scans question also offers "Use a promo code".
+
 ## Relay human actions
 
-When the CLI prints a `CLEANSLOP_ACTION_REQUIRED` block, show the human the link and code **exactly as printed** and wait. Kinds: approve (device login or Link sign-in), install (GitHub App), top-up (credits), beta (request access), reauth (reconnect GitHub), present_identity (Link), link_existing (connect Link to an existing account), ask_human (quoted terms or email-sharing question). Never open the link, never approve, never pay, never enter credentials. `cleanslop login --link` drives `link-cli` itself (Link sign-in, attestations, identity credential). Never run `link-cli … present`, `attestations pop`, or `spend-request` yourself, and never paste their output. When CleanSlop says the person must approve a payment in Link, tell them and wait. Pass `--accept-terms` / `--yes-share-email` only after the human answers yes to the quoted question in this session. After login, repeat “Connected as @login” or the masked Link email to the human.
+When the CLI prints a `CLEANSLOP_ACTION_REQUIRED` block, show the human the link and code **exactly as printed** and wait. Kinds: approve (device login, Link sign-in, or a Link payment), install (GitHub App), top-up (credits), beta (request access), reauth (reconnect GitHub), present_identity (Link), link_existing (connect Link to an existing account), ask_human (quoted terms or email-sharing question). Never open the link, never approve, never pay, never enter credentials. `cleanslop login --link` drives `link-cli` itself (Link sign-in, attestations, identity credential). Never run `link-cli … present`, `attestations pop`, or `spend-request` yourself, and never paste their output. When CleanSlop says the person must approve a payment in Link, tell them and wait. Pass `--agree` only after the human answers yes to the quoted question in this session. When a block includes a `CLEANSLOP_QUESTION:` line (a JSON question with options), ask it with your multiple-choice question tool if you have one (for example AskUserQuestion), offering exactly those options; otherwise ask in plain text. Never answer for the human. Then do what the chosen option says: run its `run` command, follow its `next` step, or stop if it has neither. After login, repeat “Connected as @login” or the masked Link email to the human.
 
 ## Waiting
 
@@ -47,7 +58,7 @@ Fix by priority, run the repo’s tests, ask the human about `needs_input`, get
 
 ## Stop conditions
 
-Stop when all listed issues are resolved; the same fingerprints are still open after one rescan; the CLI reports `out_of_scans`; the human declines; or the commit has not changed.
+Stop when all listed issues are resolved; the same fingerprints are still open after one rescan; the account is out of scans and the human does not buy more (or none can be bought); the human declines; or the commit has not changed.
 
 ## Report back
 

package/dist/action.d.ts

@@ -2,4 +2,5 @@ import type { CliDeps } from "./deps.js";
 import type { ActionRequired } from "./exit.js";
 import type { AgentScan } from "./types.js";
 export declare function writeAction(deps: CliDeps, action: ActionRequired): void;
+export declare const QUESTION_TOOL_HINT = "Ask this with your multiple-choice question tool if you have one, offering exactly these options; otherwise ask in plain text. Never answer for the human. Then do what the chosen option says: run its command, follow its next step, or stop.";
 export declare function writeResume(deps: CliDeps, scanId: string, scan?: Pick<AgentScan, "eta" | "elapsedSec">): void;

package/dist/action.js

@@ -11,9 +11,33 @@ export function writeAction(deps, action) {
     if (action.code) {
         lines.push("", `Code: ${action.code}`);
     }
+    if (action.question) {
+        lines.push("", ...questionLines(action.question));
+    }
     lines.push("", "Never open, approve, or pay yourself. Never enter credentials or payment details.");
     deps.io.stderr(`${lines.join("\n")}\n`);
 }
+export const QUESTION_TOOL_HINT = "Ask this with your multiple-choice question tool if you have one, offering exactly these options; otherwise ask in plain text. Never answer for the human. Then do what the chosen option says: run its command, follow its next step, or stop.";
+/** Numbered options, the machine-readable line, and how to ask. */
+function questionLines(question) {
+    const options = question.options.map((option, i) => {
+        const detail = option.description ? ` (${option.description})` : "";
+        const next = option.run
+            ? ` → run: ${option.run}`
+            : option.next
+                ? ` → next: ${option.next}`
+                : " → stop";
+        return `  ${i + 1}. ${option.label}${detail}${next}`;
+    });
+    return [
+        `Options:`,
+        ...options,
+        "",
+        `CLEANSLOP_QUESTION: ${JSON.stringify(question)}`,
+        "",
+        QUESTION_TOOL_HINT,
+    ];
+}
 export function writeResume(deps, scanId, scan) {
     const eta = scan ? formatEtaLine(scan) : null;
     const head = eta ? `Still running (${eta}).` : "Still running.";

package/dist/action.js.map

@@ -1 +1 @@
-{"version":3,"file":"action.js","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,MAAsB;IAC/D,MAAM,KAAK,GAAG;QACZ,8BAA8B,MAAM,CAAC,IAAI,EAAE;QAC3C,EAAE;QACF,MAAM,CAAC,WAAW;KACnB,CAAC;IACF,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,KAAK,CAAC,IAAI,CACR,EAAE,EACF,mFAAmF,CACpF,CAAC;IACF,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,IAAa,EACb,MAAc,EACd,IAA4C;IAE5C,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAChE,IAAI,CAAC,EAAE,CAAC,MAAM,CACZ,GAAG,IAAI,qCAAqC,MAAM,WAAW,CAC9D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,MAAsB;IAC/D,MAAM,KAAK,GAAG;QACZ,8BAA8B,MAAM,CAAC,IAAI,EAAE;QAC3C,EAAE;QACF,MAAM,CAAC,WAAW;KACnB,CAAC;IACF,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,KAAK,CAAC,IAAI,CACR,EAAE,EACF,mFAAmF,CACpF,CAAC;IACF,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAC7B,iPAAiP,CAAC;AAEpP,mEAAmE;AACnE,SAAS,aAAa,CAAC,QAAwB;IAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACjD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG;YACrB,CAAC,CAAC,WAAW,MAAM,CAAC,GAAG,EAAE;YACzB,CAAC,CAAC,MAAM,CAAC,IAAI;gBACX,CAAC,CAAC,YAAY,MAAM,CAAC,IAAI,EAAE;gBAC3B,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,KAAK,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IACH,OAAO;QACL,UAAU;QACV,GAAG,OAAO;QACV,EAAE;QACF,uBAAuB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE;QACjD,EAAE;QACF,kBAAkB;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,IAAa,EACb,MAAc,EACd,IAA4C;IAE5C,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAChE,IAAI,CAAC,EAAE,CAAC,MAAM,CACZ,GAAG,IAAI,qCAAqC,MAAM,WAAW,CAC9D,CAAC;AACJ,CAAC"}

package/dist/args.d.ts

@@ -1,4 +1,4 @@
 import type { ParsedArgs } from "./types.js";
 export declare function parseWaitMs(raw: string, fallback?: number): number;
 export declare function parseArgs(argv: string[], defaultWaitMs?: number): ParsedArgs;
-export declare const HELP_TEXT = "cleanslop \u2014 CleanSlop agent CLI\n\nUsage:\n  cleanslop [scan] [--wait [duration]] [--json] [--force] [--preview]\n  cleanslop login [--link] [--accept-terms] [--yes-share-email] [--no-wait | --resume]\n  cleanslop link-identity [--accept-terms] [--yes-share-email] [--no-wait | --resume]\n  cleanslop credits buy --link [--pack p5]\n  cleanslop credits buy --link --resume\n  cleanslop logout\n  cleanslop whoami\n  cleanslop status [id] [--wait [duration]]\n  cleanslop report [id] [--format md|json] [--preview]\n  cleanslop email <id> --consent \"<exact question>\" [--reply \"<human reply>\"]\n  cleanslop setup [--dry-run] [--uninstall] [--project] [--yes]\n\nscan is the default command. GitHub App repos, or a packed upload when /me\nreports uploads:true (Link). --dry-run on scan lists the upload pack.\n\nWait:\n  --wait           poll until final or the budget (default 8 minutes)\n  --wait 75m       Claude Code background budget (hours/minutes/seconds: 1h, 75m, 30s)\n  At the deadline: exit 75 and print a resume command. The scan keeps running.\n\nFlags:\n  --json           one JSON document on stdout\n  --force          skip same-commit dedupe (sends Idempotency-Key)\n  --preview        first-pass report before judgment is final\n  --no-wait        login / link-identity: print the approval link and exit 10\n  --resume         login / link-identity: continue a pending --no-wait approval\n  --link           login: Stripe Link sign-up / sign-in (requires link-cli)\n  --accept-terms   login --link: pass only after the human agrees to the quoted terms question\n  --yes-share-email  login --link / link-identity: pass only after the human answers yes to the quoted question\n  --pack           credits buy: p5, p15, or p40 (default p5). Amount and network id come from a scan 402.\n  --dry-run        setup: print the plan. scan (Link): list the pack, upload nothing\n  --uninstall      setup: remove marker blocks / skill files\n  --project        setup: project files instead of user scope\n  --yes            setup: write in a non-TTY (otherwise non-TTY is a plan only)\n  --consent        email: the exact masked-recipient question you asked\n  --reply          email: optional verbatim human reply\n\nEnv:\n  CLEANSLOP_ORIGIN   API origin (default https://cleanslop.com)\n  CLEANSLOP_TOKEN    bearer token override (never printed)\n  CLEANSLOP_LINK_CLI path to link-cli (default: link-cli on PATH)\n\nCredentials: $XDG_CONFIG_HOME/cleanslop/credentials.json or ~/.config/cleanslop/\nDirectory 0700, file 0600. Never stored inside the git worktree.\n\nExit codes: 0 ok \u00B7 1 unexpected \u00B7 2 usage \u00B7 10 human action \u00B7 11 payment\n  12 policy \u00B7 13 source \u00B7 20 scan failed \u00B7 75 still running\n\nNever open, approve, or pay yourself. Relay CLEANSLOP_ACTION_REQUIRED blocks.\n";
+export declare const HELP_TEXT = "cleanslop \u2014 CleanSlop agent CLI\n\nUsage:\n  cleanslop [scan] [--wait [duration]] [--json] [--force] [--preview]\n  cleanslop login [--link] [--agree] [--no-wait | --resume]\n  cleanslop link-identity [--agree] [--no-wait | --resume]\n  cleanslop credits buy --link [--pack p5] [--no-wait | --resume]\n  cleanslop redeem <code>\n  cleanslop logout\n  cleanslop whoami\n  cleanslop status [id] [--wait [duration]]\n  cleanslop report [id] [--format md|json] [--preview]\n  cleanslop email <id> --consent \"<exact question>\" [--reply \"<human reply>\"]\n  cleanslop setup [--dry-run] [--uninstall] [--project] [--yes]\n\nscan is the default command. GitHub App repos, or a packed upload when /me\nreports uploads:true (Link). --dry-run on scan lists the upload pack.\n\nWait:\n  --wait           poll until final or the budget (default 8 minutes)\n  --wait 75m       Claude Code background budget (hours/minutes/seconds: 1h, 75m, 30s)\n  At the deadline: exit 75 and print a resume command. The scan keeps running.\n\nFlags:\n  --json           one JSON document on stdout\n  --force          skip same-commit dedupe (sends Idempotency-Key)\n  --preview        first-pass report before judgment is final\n  --no-wait        login / link-identity / credits buy: print what to approve and exit 10\n  --resume         login / link-identity / credits buy: continue a pending --no-wait approval\n  --link           login: Stripe Link sign-up / sign-in (requires link-cli)\n  --agree          login --link / link-identity: pass only after the human answers yes to the quoted question\n                   (--accept-terms --yes-share-email together still work for login --link; --yes-share-email for link-identity)\n  --pack           credits buy: p5, p15, or p40. Required without a terminal (the human picks); a terminal defaults to p5. Price and network id come from CleanSlop.\n  --dry-run        setup: print the plan. scan (Link): list the pack, upload nothing\n  --uninstall      setup: remove marker blocks / skill files\n  --project        setup: project files instead of user scope\n  --yes            setup: write in a non-TTY (otherwise non-TTY is a plan only)\n  --consent        email: the exact masked-recipient question you asked\n  --reply          email: optional verbatim human reply\n\nEnv:\n  CLEANSLOP_ORIGIN   API origin (default https://cleanslop.com)\n  CLEANSLOP_TOKEN    bearer token override (never printed)\n  CLEANSLOP_LINK_CLI path to link-cli (default: link-cli on PATH)\n\nCredentials: $XDG_CONFIG_HOME/cleanslop/credentials.json or ~/.config/cleanslop/\nDirectory 0700, file 0600. Never stored inside the git worktree.\n\nExit codes: 0 ok \u00B7 1 unexpected \u00B7 2 usage \u00B7 10 human action \u00B7 11 payment\n  12 policy \u00B7 13 source \u00B7 20 scan failed \u00B7 75 still running\n\nNever open, approve, or pay yourself. Relay CLEANSLOP_ACTION_REQUIRED blocks.\nAsk a CLEANSLOP_QUESTION with your multiple-choice question tool if you have\none, using exactly its options. Never answer for the human.\n";

package/dist/args.js

@@ -11,6 +11,7 @@ const COMMANDS = [
     "email",
     "link-identity",
     "credits",
+    "redeem",
 ];
 function isCommand(value) {
     return COMMANDS.includes(value);
@@ -49,6 +50,7 @@ function emptyArgs(defaultWaitMs) {
         consent: null,
         reply: null,
         link: false,
+        agree: false,
         acceptTerms: false,
         yesShareEmail: false,
         pack: null,
@@ -106,6 +108,9 @@ export function parseArgs(argv, defaultWaitMs = DEFAULT_WAIT_MS) {
             case "--link":
                 out.link = true;
                 break;
+            case "--agree":
+                out.agree = true;
+                break;
             case "--accept-terms":
                 out.acceptTerms = true;
                 break;
@@ -191,10 +196,10 @@ export const HELP_TEXT = `cleanslop — CleanSlop agent CLI
 
 Usage:
   cleanslop [scan] [--wait [duration]] [--json] [--force] [--preview]
-  cleanslop login [--link] [--accept-terms] [--yes-share-email] [--no-wait | --resume]
-  cleanslop link-identity [--accept-terms] [--yes-share-email] [--no-wait | --resume]
-  cleanslop credits buy --link [--pack p5]
-  cleanslop credits buy --link --resume
+  cleanslop login [--link] [--agree] [--no-wait | --resume]
+  cleanslop link-identity [--agree] [--no-wait | --resume]
+  cleanslop credits buy --link [--pack p5] [--no-wait | --resume]
+  cleanslop redeem <code>
   cleanslop logout
   cleanslop whoami
   cleanslop status [id] [--wait [duration]]
@@ -214,12 +219,12 @@ Flags:
   --json           one JSON document on stdout
   --force          skip same-commit dedupe (sends Idempotency-Key)
   --preview        first-pass report before judgment is final
-  --no-wait        login / link-identity: print the approval link and exit 10
-  --resume         login / link-identity: continue a pending --no-wait approval
+  --no-wait        login / link-identity / credits buy: print what to approve and exit 10
+  --resume         login / link-identity / credits buy: continue a pending --no-wait approval
   --link           login: Stripe Link sign-up / sign-in (requires link-cli)
-  --accept-terms   login --link: pass only after the human agrees to the quoted terms question
-  --yes-share-email  login --link / link-identity: pass only after the human answers yes to the quoted question
-  --pack           credits buy: p5, p15, or p40 (default p5). Amount and network id come from a scan 402.
+  --agree          login --link / link-identity: pass only after the human answers yes to the quoted question
+                   (--accept-terms --yes-share-email together still work for login --link; --yes-share-email for link-identity)
+  --pack           credits buy: p5, p15, or p40. Required without a terminal (the human picks); a terminal defaults to p5. Price and network id come from CleanSlop.
   --dry-run        setup: print the plan. scan (Link): list the pack, upload nothing
   --uninstall      setup: remove marker blocks / skill files
   --project        setup: project files instead of user scope
@@ -239,5 +244,7 @@ Exit codes: 0 ok · 1 unexpected · 2 usage · 10 human action · 11 payment
   12 policy · 13 source · 20 scan failed · 75 still running
 
 Never open, approve, or pay yourself. Relay CLEANSLOP_ACTION_REQUIRED blocks.
+Ask a CLEANSLOP_QUESTION with your multiple-choice question tool if you have
+one, using exactly its options. Never answer for the human.
 `;
 //# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}

package/dist/commands/credits.d.ts

@@ -12,18 +12,47 @@ export type StripeSptOffer = {
     currency: string;
     networkId: string;
     purchaseUrl: string;
+    /** CleanSlop marks one pack as the best value. */
+    best?: boolean;
 };
 /** Fixed Link approval budget. Auto-buy ignores `scan --wait`. */
 export declare const LINK_APPROVAL_WAIT_MS: number;
+/**
+ * `--resume` budget. The human has usually approved already; anything longer
+ * would outlast an agent's foreground shell call.
+ */
+export declare const LINK_RESUME_WAIT_MS: number;
+/**
+ * How long to poll Link for approval. `--no-wait` checks once, `--resume`
+ * polls briefly, and the default (a human at a terminal) waits 10 minutes.
+ */
 export declare function linkApprovalWaitMs(args: ParsedArgs, opts?: {
     autoBuy?: boolean;
 }): number;
+/** Cents to a display price, e.g. `5.00 USD`. */
+export declare function formatPackPrice(amount: number, currency: string): string;
+/** `p15 (15 scans, 25.00 USD, 1.67 USD per scan, best value)`. */
+export declare function describePackOffer(offer: StripeSptOffer): string;
+/** Every `stripe_spt` offer in a 402 `out_of_scans` body, in server order. */
+export declare function stripeSptOffersFromErrorBody(json: unknown): StripeSptOffer[];
 /** Read a matching `stripe_spt` offer from a 402 `out_of_scans` body. */
 export declare function stripeSptOfferFromErrorBody(json: unknown, packHint: string | null): StripeSptOffer | null;
+/**
+ * Buys a Link credit pack. Default mode (a human at a terminal) creates the
+ * spend request and waits up to 10 minutes. `--no-wait` creates it (or checks
+ * the saved one), prints the approve block, and exits 10; `--resume` finishes
+ * the saved request. A saved request for this origin is always reused rather
+ * than replaced, so retries never send the person a second approval.
+ */
 export declare function buyLinkCredits(deps: CliDeps, args: ParsedArgs, offer?: StripeSptOffer | null, opts?: {
     autoBuy?: boolean;
 }): Promise<number>;
 export declare function runCredits(deps: CliDeps, args: ParsedArgs): Promise<number>;
-/** If a scan 402 offers `stripe_spt`, buy that pack and retry the scan once. */
+/**
+ * If a scan 402 offers `stripe_spt`: a human at a terminal buys that pack in
+ * place and the scan retries once. An agent (no TTY) gets a top-up block that
+ * sends it through `credits buy --link --no-wait` / `--resume`, because a
+ * 10-minute approval wait outlasts its shell call.
+ */
 export declare function recoverOutOfScansIfOffered(deps: CliDeps, args: ParsedArgs, result: HttpResult, retry: () => Promise<HttpResult>): Promise<HttpResult>;
 export {};