@zenera/cli 1.1.10 → 1.1.12

package/README.md

@@ -97,6 +97,7 @@ agents:
       description: Turns a summary into a file on disk.
       system: agents/prompts/writer.md
       tools: [workspace:*]
+      handoffs: [reader] # a hand-off does not return by itself; give it a way back
 ```
 
 `agents/prompts/reader.md`:
@@ -133,17 +134,27 @@ Credentials live in `$HOME`, so the project never contains a secret.
 
 ```
 my-project/
+    SPECIFICATION.md             what this is for — the intent
     INSTRUCTIONS.md              house rules, prepended to every agent
     agents.yaml                  who exists, what they may reach for
     agents/
         prompts/<name>.md        each agent's own brief
         skills/<name>/           knowledge loaded on demand, not always-on
+    assets/                      reference material, read-only at /assets
+    sandbox/Dockerfile           the container commands run in
+    scripts/_setup.sh            the one command that initialises the project
     sessions/                    one workspace, memory and trajectory each
         <id>/
             workspace/           what the agents can read and write
             runs/<id>/           input, output, state, report.html, meta
 ```
 
+`SPECIFICATION.md` comes first because the rest implements it. The one `zen init`
+writes is a true specification of the project it just scaffolded; replace it with
+what you are building, then run `/sync-with-spec` in your editor to make the
+files match. See
+[docs/specification.md](https://github.com/andreyryabov/ZeneraNeo/blob/main/docs/specification.md).
+
 `zen init` also writes `.github/copilot-instructions.md` — a standing brief that
 explains this runtime to whatever coding agent you have open in that folder, so
 you are not expected to hand-author `agents.yaml`.
@@ -159,8 +170,10 @@ you are not expected to hand-author `agents.yaml`.
 | `models`  | What this machine can use — list, search, test, pick.                |
 | `run`     | Runs the project — the TUI on a terminal, a single answer otherwise. |
 | `inspect` | Opens or rebuilds a run's `report.html`.                             |
+| `memory`  | What the agents remember — size, listing, one node, or a whole page. |
 | `check`   | Validates the project and every file it names, and asks the models.  |
 | `sandbox` | Checks and prepares the container that command-line tools run in.    |
+| `cache`   | What work has been kept, and getting rid of it.                      |
 | `version` | CLI, library and Node versions.                                      |
 
 Commands can also come from a package installed alongside this one, so a new
@@ -254,7 +267,7 @@ zen models test vertex:gemini-embedding-001 # one real call, one verdict
 zen models pick --embedding                 # the first ref that answers, on stdout
 ```
 
-Listings are cached for a day in `~/.zenera/neo/catalog`. When a provider cannot
+Listings are cached for a day in `~/.zenera/neo/cache`. When a provider cannot
 be asked the last listing is used and said to be stale; only if there was never
 one does a short built-in list stand in.
 
@@ -292,7 +305,7 @@ The usual one is a **service-account JSON file** — give its path, not its
 contents. Run the command with nothing piped and it asks:
 
 ```sh
-zen key add vertex --location us-central1
+zen key add vertex --gcp-location us-central1
 # Paste the key, or a path to the file: /Users/you/keys/vertex-sa.json
 ```
 
@@ -300,23 +313,29 @@ The prompt is read by `zen`, not by your shell, so give a full path there — `~
 is not expanded. In a script, pipe the path in instead:
 
 ```sh
-echo ~/keys/vertex-sa.json | zen key add vertex --location us-central1
+echo ~/keys/vertex-sa.json | zen key add vertex --gcp-location us-central1
 ```
 
 The file is copied into `~/.zenera/neo/keys/`, where only you can read it, so
 moving or cleaning up the original later cannot break it.
 
-- `--location <region>` is worth setting. It must be `global` or a **concrete
-  region**; multi-region names like `us` are rejected with a 404. `global`
-  routes across regions and pays about ten seconds of cold start on the first
-  request each process makes — a region answers in about two.
-- `--project <id>` is only needed when the `project_id` inside the file is not
+- `--gcp-location <region>` is worth setting. It takes a concrete region, or one
+  of the endpoints that route across regions: `us` and `eu` pool capacity while
+  keeping processing inside that territory, `global` takes whatever is free and
+  promises no residency. `global` pays about ten seconds of cold start on the
+  first request each process makes — a region answers in about two.
+- Which models a location serves is per model, and not guessable. In one
+  project, `gemini-embedding-2` answered at `us` but 404'd at `us-central1`,
+  while `gemini-2.5-flash` did the opposite. New models often reach `global`,
+  `us` and `eu` first. `zen models test vertex:<model>` is what settles it —
+  `zen key add` only establishes that the credential itself works.
+- `--gcp-project <id>` is only needed when the `project_id` inside the file is not
   the project you want.
 
 The alternative is an **express-mode API key** — a single secret, stored under
 `VERTEX_API_KEY`. It is the Vertex console's way of handing out access without a
-service account, and it needs neither a project nor a region, so `--project` and
-`--location` mean nothing there and are not stored.
+service account, and it needs neither a project nor a region, so `--gcp-project`
+and `--gcp-location` mean nothing there and are not stored.
 
 ### Gemini, three ways
 
@@ -336,15 +355,15 @@ and a region, because the file says which project it belongs to but never which
 region to call:
 
 ```sh
-echo ~/keys/vertex-sa.json | zen key add vertex --location us-central1
+echo ~/keys/vertex-sa.json | zen key add vertex --gcp-location us-central1
 ```
 
-Add `--project` only when the `project_id` inside the file is not the one you
+Add `--gcp-project` only when the `project_id` inside the file is not the one you
 want to bill:
 
 ```sh
 echo ~/keys/vertex-sa.json \
-  | zen key add vertex --project other-project --location europe-west4
+  | zen key add vertex --gcp-project other-project --gcp-location europe-west4
 ```
 
 **Vertex, express mode** — paste the key at the prompt; no flags apply:
@@ -356,8 +375,8 @@ zen key add vertex
 Holding several at once is the ordinary case. Name them and switch:
 
 ```sh
-echo ~/keys/prod-sa.json | zen key add vertex/prod --location us-central1
-echo ~/keys/dev-sa.json  | zen key add vertex/dev  --location global
+echo ~/keys/prod-sa.json | zen key add vertex/prod --gcp-location us-central1
+echo ~/keys/dev-sa.json  | zen key add vertex/dev  --gcp-location global
 zen key add vertex/express       # the express key, same provider
 
 zen key use vertex/dev           # which one the next run uses
@@ -413,6 +432,32 @@ clear where a working provider actually comes from.
 - **Keyring** — `~/.zenera/neo`, readable only by you. Keys are copied into the
   environment just before a run, so an environment variable you set yourself
   always wins and a project checked out on a machine without `zen` still runs.
+- **Cache** — `~/.zenera/neo/cache`, one place for work already done: vectors,
+  parses, model listings, generated mocks. Shared by every project on the
+  machine, and never evicted by anything but you.
+
+## What has already been paid for
+
+Embedding a paragraph, parsing a document, asking a provider what it serves —
+all expensive, all perfectly repeatable. They are kept in one store,
+`~/.zenera/neo/cache/<kind>/`, keyed by every input that produced them. Change
+an input and you are asking a different question, which is why nothing in there
+is ever invalidated: it is simply never asked for again.
+
+```
+zen cache ls                          # what is kept, by kind
+zen cache ls --kind vectors           # and what is in one of them
+zen cache prune --older-than 30d      # drop what has gone unread for a month
+zen cache prune --max-size 2GB        # or keep it under a ceiling
+zen cache clear --kind docs-parse     # throw one kind away
+```
+
+Age is when an entry was last _used_, not when it was written, so a vector a
+weekly rebuild reads is never old. Nothing evicts on its own — a store that
+quietly deletes things is only ever noticed when it has deleted the wrong one —
+so retention is a decision made out loud, here. Nothing in it is precious
+either: every entry is work that can be done again, and the only cost of
+removing one is paying for it a second time.
 
 ## The library underneath
 
@@ -425,11 +470,20 @@ terminal:
 
 ## Documentation
 
+[docs/specification.md](https://github.com/andreyryabov/ZeneraNeo/blob/main/docs/specification.md)
+— writing the specification the project implements ·
 [docs/projects.md](https://github.com/andreyryabov/ZeneraNeo/blob/main/docs/projects.md)
 — the folder a project is ·
 [docs/agents-yaml.md](https://github.com/andreyryabov/ZeneraNeo/blob/main/docs/agents-yaml.md)
 — every key in the configuration file.
 
+[docs/knowledge.md](https://github.com/andreyryabov/ZeneraNeo/blob/main/docs/knowledge.md)
+— a searchable document index ·
+[docs/integrations.md](https://github.com/andreyryabov/ZeneraNeo/blob/main/docs/integrations.md)
+— an API description, searchable and mockable ·
+[docs/memory.md](https://github.com/andreyryabov/ZeneraNeo/blob/main/docs/memory.md)
+— what agents keep between sessions.
+
 ## License
 
 Early days and moving fast — issues, questions and pull requests are welcome.

package/dist/banner.js

@@ -8,64 +8,80 @@ import { dim, note } from "./term.js";
 // terminal — a pipeline asking for the answer gets the answer, and a CI log is
 // not decorated with block letters.
 //
-// The font is here rather than pulled in as a dependency because it is a
-// kilobyte of constant and the whole CLI is otherwise Node's own. Two things
-// about its shape are deliberate: the stroke is **two cells wide**, because a
-// one-cell stem in a dotted fill reads as noise rather than as a letter, and
-// the ink is the dotted block (U+2592) rather than a solid one, which makes a
-// thick stroke a screen-print instead of a slab.
+// The font is here rather than pulled in as a dependency because it is a couple
+// of kilobytes of constant and the whole CLI is otherwise Node's own. It is the
+// shadowed block face: a solid stroke lit from the top left with a box-drawing
+// bevel down its right side and along its foot, so the letters read as raised
+// rather than as a texture. Glyphs are variable width and carry their own
+// spacing, so they abut directly — the gap belongs to the letter, not the join.
 //
 // A terminal too narrow for the art gets the wordmark on one line. A banner
 // that wraps is worse than no banner.
 // ---------------------------------------------------------------------------
-const HEIGHT = 5;
-const WIDTH = 6;
+const HEIGHT = 6;
+/** Between the two words. Wide enough that they read as two, not as one. */
+const GAP = 3;
+/** A left margin, so the art does not start against the edge of the screen. */
+const INDENT = 2;
 const FONT = {
-    A: [' ▒▒▒▒ ', '▒▒  ▒▒', '▒▒▒▒▒▒', '▒▒  ▒▒', '▒▒  ▒▒'],
-    B: ['▒▒▒▒▒ ', '▒▒  ▒▒', '▒▒▒▒▒ ', '▒▒  ▒▒', '▒▒▒▒▒ '],
-    C: [' ▒▒▒▒▒', '▒▒    ', '▒▒    ', '▒▒    ', ' ▒▒▒▒▒'],
-    D: ['▒▒▒▒▒ ', '▒▒  ▒▒', '▒▒  ▒▒', '▒▒  ▒▒', '▒▒▒▒▒ '],
-    E: ['▒▒▒▒▒▒', '▒▒    ', '▒▒▒▒▒ ', '▒▒    ', '▒▒▒▒▒▒'],
-    F: ['▒▒▒▒▒▒', '▒▒    ', '▒▒▒▒▒ ', '▒▒    ', '▒▒    '],
-    G: [' ▒▒▒▒▒', '▒▒    ', '▒▒ ▒▒▒', '▒▒  ▒▒', ' ▒▒▒▒▒'],
-    H: ['▒▒  ▒▒', '▒▒  ▒▒', '▒▒▒▒▒▒', '▒▒  ▒▒', '▒▒  ▒▒'],
-    I: ['▒▒▒▒▒▒', '  ▒▒  ', '  ▒▒  ', '  ▒▒  ', '▒▒▒▒▒▒'],
-    J: ['▒▒▒▒▒▒', '   ▒▒ ', '   ▒▒ ', '▒▒ ▒▒ ', ' ▒▒▒  '],
-    K: ['▒▒  ▒▒', '▒▒ ▒▒ ', '▒▒▒▒  ', '▒▒ ▒▒ ', '▒▒  ▒▒'],
-    L: ['▒▒    ', '▒▒    ', '▒▒    ', '▒▒    ', '▒▒▒▒▒▒'],
-    M: ['▒▒  ▒▒', '▒▒▒▒▒▒', '▒▒▒▒▒▒', '▒▒  ▒▒', '▒▒  ▒▒'],
-    N: ['▒▒  ▒▒', '▒▒▒ ▒▒', '▒▒▒▒▒▒', '▒▒ ▒▒▒', '▒▒  ▒▒'],
-    O: [' ▒▒▒▒ ', '▒▒  ▒▒', '▒▒  ▒▒', '▒▒  ▒▒', ' ▒▒▒▒ '],
-    P: ['▒▒▒▒▒ ', '▒▒  ▒▒', '▒▒▒▒▒ ', '▒▒    ', '▒▒    '],
-    Q: [' ▒▒▒▒ ', '▒▒  ▒▒', '▒▒  ▒▒', '▒▒ ▒▒ ', ' ▒▒ ▒▒'],
-    R: ['▒▒▒▒▒ ', '▒▒  ▒▒', '▒▒▒▒▒ ', '▒▒ ▒▒ ', '▒▒  ▒▒'],
-    S: [' ▒▒▒▒▒', '▒▒    ', ' ▒▒▒▒ ', '    ▒▒', '▒▒▒▒▒ '],
-    T: ['▒▒▒▒▒▒', '  ▒▒  ', '  ▒▒  ', '  ▒▒  ', '  ▒▒  '],
-    U: ['▒▒  ▒▒', '▒▒  ▒▒', '▒▒  ▒▒', '▒▒  ▒▒', ' ▒▒▒▒ '],
-    V: ['▒▒  ▒▒', '▒▒  ▒▒', '▒▒  ▒▒', ' ▒▒▒▒ ', '  ▒▒  '],
-    W: ['▒▒  ▒▒', '▒▒  ▒▒', '▒▒▒▒▒▒', '▒▒▒▒▒▒', '▒▒  ▒▒'],
-    X: ['▒▒  ▒▒', ' ▒▒▒▒ ', '  ▒▒  ', ' ▒▒▒▒ ', '▒▒  ▒▒'],
-    Y: ['▒▒  ▒▒', ' ▒▒▒▒ ', '  ▒▒  ', '  ▒▒  ', '  ▒▒  '],
-    Z: ['▒▒▒▒▒▒', '   ▒▒ ', '  ▒▒  ', ' ▒▒   ', '▒▒▒▒▒▒'],
+    A: [' █████╗ ', '██╔══██╗', '███████║', '██╔══██║', '██║  ██║', '╚═╝  ╚═╝'],
+    B: ['██████╗ ', '██╔══██╗', '██████╔╝', '██╔══██╗', '██████╔╝', '╚═════╝ '],
+    C: [' ██████╗', '██╔════╝', '██║     ', '██║     ', '╚██████╗', ' ╚═════╝'],
+    D: ['██████╗ ', '██╔══██╗', '██║  ██║', '██║  ██║', '██████╔╝', '╚═════╝ '],
+    E: ['███████╗', '██╔════╝', '█████╗  ', '██╔══╝  ', '███████╗', '╚══════╝'],
+    F: ['███████╗', '██╔════╝', '█████╗  ', '██╔══╝  ', '██║     ', '╚═╝     '],
+    G: [' ██████╗ ', '██╔════╝ ', '██║  ███╗', '██║   ██║', '╚██████╔╝', ' ╚═════╝ '],
+    H: ['██╗  ██╗', '██║  ██║', '███████║', '██╔══██║', '██║  ██║', '╚═╝  ╚═╝'],
+    I: ['██╗', '██║', '██║', '██║', '██║', '╚═╝'],
+    J: ['     ██╗', '     ██║', '     ██║', '██   ██║', '╚█████╔╝', ' ╚════╝ '],
+    K: ['██╗  ██╗', '██║ ██╔╝', '█████╔╝ ', '██╔═██╗ ', '██║  ██╗', '╚═╝  ╚═╝'],
+    L: ['██╗     ', '██║     ', '██║     ', '██║     ', '███████╗', '╚══════╝'],
+    M: ['███╗   ███╗', '████╗ ████║', '██╔████╔██║', '██║╚██╔╝██║', '██║ ╚═╝ ██║', '╚═╝     ╚═╝'],
+    N: ['███╗   ██╗', '████╗  ██║', '██╔██╗ ██║', '██║╚██╗██║', '██║ ╚████║', '╚═╝  ╚═══╝'],
+    O: [' ██████╗ ', '██╔═══██╗', '██║   ██║', '██║   ██║', '╚██████╔╝', ' ╚═════╝ '],
+    P: ['██████╗ ', '██╔══██╗', '██████╔╝', '██╔═══╝ ', '██║     ', '╚═╝     '],
+    Q: [' ██████╗ ', '██╔═══██╗', '██║   ██║', '██║▄▄ ██║', '╚██████╔╝', ' ╚══▀▀═╝ '],
+    R: ['██████╗ ', '██╔══██╗', '██████╔╝', '██╔══██╗', '██║  ██║', '╚═╝  ╚═╝'],
+    S: ['███████╗', '██╔════╝', '███████╗', '╚════██║', '███████║', '╚══════╝'],
+    T: ['████████╗', '╚══██╔══╝', '   ██║   ', '   ██║   ', '   ██║   ', '   ╚═╝   '],
+    U: ['██╗   ██╗', '██║   ██║', '██║   ██║', '██║   ██║', '╚██████╔╝', ' ╚═════╝ '],
+    V: ['██╗   ██╗', '██║   ██║', '██║   ██║', '╚██╗ ██╔╝', ' ╚████╔╝ ', '  ╚═══╝  '],
+    W: ['██╗    ██╗', '██║    ██║', '██║ █╗ ██║', '██║███╗██║', '╚███╔███╔╝', ' ╚══╝╚══╝ '],
+    X: ['██╗  ██╗', '╚██╗██╔╝', ' ╚███╔╝ ', ' ██╔██╗ ', '██╔╝ ██╗', '╚═╝  ╚═╝'],
+    Y: ['██╗   ██╗', '╚██╗ ██╔╝', ' ╚████╔╝ ', '  ╚██╔╝  ', '   ██║   ', '   ╚═╝   '],
+    Z: ['███████╗', '╚══███╔╝', '  ███╔╝ ', ' ███╔╝  ', '███████╗', '╚══════╝'],
 };
-const BLANK = ' '.repeat(WIDTH);
-/** One word as five rows of equal length — so two words line up when joined. */
+const BLANK = ['    ', '    ', '    ', '    ', '    ', '    '];
+/** One word as six rows of equal length — so two words line up when joined. */
 function big(word) {
     const rows = new Array(HEIGHT).fill('');
     for (const ch of word.toUpperCase()) {
-        const glyph = FONT[ch];
+        const glyph = FONT[ch] ?? BLANK;
         for (let r = 0; r < HEIGHT; r++) {
-            rows[r] += `${glyph?.[r] ?? BLANK} `;
+            rows[r] += glyph[r];
         }
     }
     return rows;
 }
 /** A wordmark rather than a sentence, so the letters are set apart. */
 const spaced = (s) => [...s.toUpperCase()].join(' ');
-/** The name, in the brightest thing the terminal has. */
-const bright = (s) => styleText(['bold', 'whiteBright'], s);
-/** The half that carries the colour. */
-const neon = (s) => styleText(['bold', 'magentaBright'], s);
+/** Whether anything should be coloured at all — `styleText`'s own answer. */
+const styling = () => styleText('dim', '.') !== '.';
+const RESET = '\u001b[0m';
+const HEAD = { face: '\u001b[1;38;5;231m', shade: '\u001b[0;38;5;244m' };
+const ACCENT = { face: '\u001b[1;38;5;208m', shade: '\u001b[0;38;5;130m' };
+/** Runs of stroke and runs of bevel, alternating; spaces stay unstyled. */
+const RUNS = /[█▀▄]+|[^█▀▄ ]+/g;
+const isStroke = (run) => /[█▀▄]/.test(run);
+/**
+ * Two tones per word — without the darker bevel the letter is a flat outline
+ * and the shadow reads as part of the stroke.
+ */
+const paint = (text, tone) => styling()
+    ? text.replace(RUNS, (run) => `${isStroke(run) ? tone.face : tone.shade}${run}${RESET}`)
+    : text;
+/** The wordmark has no bevel to shade, so it is all face. */
+const flat = (text, tone) => styling() ? `${tone.face}${text}${RESET}` : text;
 export const NEO_BANNER = {
     head: 'Zenera',
     accent: 'Neo',
@@ -76,17 +92,23 @@ export function bannerLines(text, columns = process.stderr.columns || 80) {
     // Trimmed: the widest accent row is the banner's right edge, and a pad left
     // inside a styled string cannot be trimmed away later.
     const accent = big(text.accent).map((row) => row.trimEnd());
-    const width = 2 + head[0].length + Math.max(...accent.map((row) => row.length));
-    const foot = `  ${dim(spaced(text.subtitle))}`;
+    const margin = ' '.repeat(INDENT);
+    const width = INDENT + head[0].length + GAP + Math.max(...accent.map((row) => row.length));
     if (width > columns) {
-        return [` ${bright(text.head.toUpperCase())} ${neon(text.accent.toUpperCase())}`, foot];
+        return [
+            `${margin}${flat(text.head.toUpperCase(), HEAD)} ${flat(text.accent.toUpperCase(), ACCENT)}`,
+            `${margin}${dim(spaced(text.subtitle))}`,
+        ];
     }
     const lines = [];
     for (let r = 0; r < HEIGHT; r++) {
-        lines.push(` ${bright(head[r])} ${neon(accent[r])}`);
+        lines.push(`${margin}${paint(head[r], HEAD)}${' '.repeat(GAP)}${paint(accent[r], ACCENT)}`);
     }
+    // Rules on both sides, centred under the art: the subtitle is a caption,
+    // and without them a short line of spaced capitals floats.
+    const caption = `───  ${spaced(text.subtitle)}  ───`;
     lines.push('');
-    lines.push(foot);
+    lines.push(`${' '.repeat(Math.max(INDENT, Math.round((width - caption.length) / 2)))}${dim(caption)}`);
     return lines;
 }
 /** Narration, and only for someone watching. */

package/dist/cache.d.ts

@@ -0,0 +1,98 @@
+export interface CacheOptions {
+    /** where the store lives; defaults to `~/.zenera/neo/cache` */
+    dir?: string;
+    /** file mode, 0600 unless the value is public */
+    mode?: number;
+}
+export interface CacheEntry<T> {
+    value: T;
+    /** when it was written, for callers that have an opinion about freshness */
+    storedAt: string;
+}
+/** What a `Cache` does, so that `NO_CACHE` can be one without being one. */
+export interface CacheStore {
+    readonly kind: string;
+    readonly hits: number;
+    readonly misses: number;
+    entry<T>(key: string): CacheEntry<T> | undefined;
+    get<T>(key: string): T | undefined;
+    put(key: string, value: unknown): void;
+    delete(key: string): void;
+    commit(): void;
+}
+/** Joins the parts of a composite key. NUL cannot occur in any of them. */
+export declare function cacheKey(...parts: readonly (string | number | undefined)[]): string;
+export declare class Cache implements CacheStore {
+    #private;
+    readonly kind: string;
+    constructor(kind: string, options?: CacheOptions);
+    get hits(): number;
+    get misses(): number;
+    entry<T>(key: string): CacheEntry<T> | undefined;
+    get<T>(key: string): T | undefined;
+    put(key: string, value: unknown): void;
+    delete(key: string): void;
+    commit(): void;
+}
+/** Remembers nothing, for `--no-cache` and for anywhere a store cannot be opened. */
+export declare const NO_CACHE: CacheStore;
+export interface CacheKind {
+    kind: string;
+    entries: number;
+    bytes: number;
+    /** epoch ms of the least and most recently used entry; absent when empty */
+    oldest?: number;
+    newest?: number;
+}
+export interface CacheItem {
+    kind: string;
+    key: string;
+    bytes: number;
+    /** epoch ms, last used */
+    usedAt: number;
+    storedAt?: string;
+    /** what was stored — the file is parsed anyway to recover the key */
+    value?: unknown;
+}
+/** A row per kind, for `zen cache ls`. One stat walk; nothing is parsed. */
+export declare function kinds(dir?: string): CacheKind[];
+/**
+ * The entries of one kind, most recently used first. Reading a key means
+ * parsing the file, so the sort happens on stat data and only what will be
+ * shown is opened.
+ */
+export declare function items(kind: string, options?: {
+    dir?: string;
+    limit?: number;
+}): {
+    rows: CacheItem[];
+    found: number;
+};
+export interface SweepOptions {
+    dir?: string;
+    /** only this kind */
+    kind?: string;
+    /** anything unused for longer than this */
+    olderThanMs?: number;
+    /** a ceiling on what is left, met by removing the least recently used */
+    maxBytes?: number;
+}
+export interface Swept {
+    kind: string;
+    removed: number;
+    bytes: number;
+}
+/**
+ * Removes what the options describe and reports what went, by kind.
+ *
+ * `maxBytes` applies to the whole selection rather than to each kind
+ * separately: the disk is one thing, and least-recently-used across the store
+ * is the only ordering that means anything on it.
+ */
+export declare function sweep(options?: SweepOptions): Swept[];
+/** Everything, or one kind of everything. */
+export declare function clear(options?: {
+    dir?: string;
+    kind?: string;
+}): void;
+//# sourceMappingURL=cache.d.ts.map