windows-development-sandbox 1.10.0 → 1.11.3

package/dist/cli/menu/add-agent.js

@@ -1,168 +0,0 @@
-// "Add an agent": a few questions (how it installs, its name, its package or program) that end in a new entry of
-// `harnesses` in your own config file. It is written at once, unless harnesses has unsaved changes in Settings (then
-// it joins them). Everything else about the agent (arguments, login folders ...) is edited in Settings > Agents &
-// sessions.
-import { DEFAULTS } from '../../core/config/index.js';
-import { HarnessSchema, NameSchema, describeIssues } from '../../core/schema/index.js';
-import { fail } from '../../core/util/index.js';
-import { askPath } from './settings/ask-path.js';
-/** Nothing wrong with the name (true), or what is wrong. Pure. */
-export function agentNameProblem(name, taken) {
-    const typed = name.trim();
-    if (!typed)
-        return 'Type a name.';
-    const parsed = NameSchema.safeParse(typed);
-    if (!parsed.success)
-        return 'Use letters, numbers, - and _ only.';
-    if (taken.some((t) => t.toLowerCase() === typed.toLowerCase()))
-        return typed + ' is an agent already.';
-    return true;
-}
-/** The command a package usually provides: "@scope/my-agent@latest" gives "my-agent". Pure. */
-export function commandFromPackage(pkg) {
-    const version = pkg.lastIndexOf('@');
-    const bare = version > 0 ? pkg.slice(0, version) : pkg;
-    return (bare.split(/[\\/]/).pop() ?? '').replace(/[^A-Za-z0-9._-]/g, '');
-}
-/** The config entry for a new agent. Pure. */
-export function newAgent(source, what, command, hostDir = 'auto') {
-    const common = { arguments: [], environment: {} };
-    if (source === 'npm')
-        return { ...common, npmPackage: what, npmBin: command };
-    if (source === 'uv')
-        return { ...common, uvPackage: what, uvBin: command };
-    return { ...common, hostExecutable: what, hostDir };
-}
-/** What `harnesses` should say with `name` taken out. Pure. */
-export function withoutAgent(current, name) {
-    const rest = { ...(current && typeof current === 'object' ? current : {}) };
-    delete rest[name];
-    return rest;
-}
-/** Writes a setting to your config file now, or adds it to the unsaved changes when it has some already. */
-export function writeOrStage(file, draft, key, value) {
-    if (draft.has(file, key)) {
-        draft.stage(file, key, value);
-        return { saved: false };
-    }
-    const result = file.set(key, value);
-    if (typeof result === 'object')
-        fail('It could not be saved: ' + result.problems.join('; '));
-    return { saved: true };
-}
-/** What `harnesses` should say with `name` added to what is staged or in the file now. Pure. */
-export function withAgent(current, name, harness) {
-    return { ...(current && typeof current === 'object' ? current : {}), [name]: harness };
-}
-/** The staged value of a setting, else what your own file says (what `harnesses` or `defaultHarness` will be). */
-function current(file, draft, key) {
-    return draft.has(file, key) ? draft.value(file, key) : file.valueInFile(key);
-}
-/** Makes `name` the agent that starts by default (written now, or joined to unsaved changes to that setting). */
-export function makeDefaultAgent(file, draft, name) {
-    return writeOrStage(file, draft, ['defaultHarness'], name);
-}
-/** Takes an agent you added out of your settings (the built-in ones are not removable). */
-export function removeAgent(file, draft, name) {
-    if (name in DEFAULTS.harnesses)
-        fail(name + ' is built in, so it cannot be removed.');
-    const key = ['harnesses'];
-    const standing = current(file, draft, ['defaultHarness']) ?? file.userConfig().defaultHarness;
-    if (standing === name)
-        fail(name + ' is the default agent.', 'Make another agent the default first.');
-    const rest = withoutAgent(current(file, draft, key), name);
-    // Nothing of your own left: the setting goes (the built-in agents need no line).
-    return writeOrStage(file, draft, key, Object.keys(rest).length ? rest : undefined);
-}
-export class AddAgent {
-    app;
-    file;
-    draft;
-    taken;
-    constructor(app, file, draft, 
-    /** Every agent that exists now (the new name must be different). */
-    taken) {
-        this.app = app;
-        this.file = file;
-        this.draft = draft;
-        this.taken = taken;
-    }
-    /** Asks, then adds the agent. Undefined when you backed out. */
-    async run() {
-        const path = ['Agents', 'Add an agent'];
-        const source = await this.app.choose(path, 'How does the agent get into the sandbox?', [
-            {
-                value: 'npm',
-                label: 'An npm package',
-                description: 'Installed inside the sandbox with npm once and kept (e.g. @openai/codex).',
-            },
-            {
-                value: 'uv',
-                label: 'A Python package',
-                description: 'Installed inside the sandbox with uv once and kept (e.g. aider-chat).',
-            },
-            {
-                value: 'host',
-                label: 'A program on this PC',
-                description: 'An .exe copied from this PC into the sandbox (looked up on PATH and in ~/.local/bin).',
-            },
-        ]);
-        if (!source)
-            return undefined;
-        const name = await this.app.text({
-            path,
-            label: 'Name of the agent',
-            about: ['What you type after "sandbox", e.g. sandbox <name>. Letters, numbers, - and _.'],
-            validate: (v) => agentNameProblem(v, this.taken),
-        });
-        if (!name)
-            return undefined;
-        if (source === 'host') {
-            const exe = await askPath(this.app, {
-                path,
-                title: 'Choose the program (.exe)',
-                about: ['The agent program on this PC. It is copied into the sandbox. A bare file name is looked up on PATH.'],
-                kind: 'file',
-                validate: (v) => (v.trim() ? true : 'Choose a file.'),
-            });
-            if (!exe)
-                return undefined;
-            const slash = Math.max(exe.lastIndexOf('\\'), exe.lastIndexOf('/'));
-            const dir = slash > 0 ? exe.slice(0, slash) : 'auto';
-            return this.add(name.trim(), newAgent('host', exe.slice(slash + 1), '', dir));
-        }
-        const what = await this.app.text({
-            path,
-            label: source === 'npm' ? 'npm package' : 'Python package',
-            about: [
-                source === 'npm'
-                    ? 'The package to install, optionally with a version: @scope/name or name@latest.'
-                    : 'The package for `uv tool install`.',
-            ],
-            validate: (v) => (v.trim() ? true : 'Type it.'),
-        });
-        if (!what)
-            return undefined;
-        const command = await this.app.text({
-            path,
-            label: 'Command',
-            about: ['The command the package provides; it is what runs inside the sandbox.'],
-            initial: commandFromPackage(what.trim()),
-            validate: (v) => (/^[A-Za-z0-9._-]+$/.test(v.trim()) ? true : 'Letters, numbers, . - and _ only.'),
-        });
-        if (!command)
-            return undefined;
-        return this.add(name.trim(), newAgent(source, what.trim(), command.trim()));
-    }
-    /** Validates and writes (or stages) the entry. */
-    add(name, harness) {
-        const checked = HarnessSchema.safeParse(harness);
-        if (!checked.success)
-            fail('That agent is not valid: ' + describeIssues(checked.error).join('; '));
-        const key = ['harnesses'];
-        return {
-            name,
-            ...writeOrStage(this.file, this.draft, key, withAgent(current(this.file, this.draft, key), name, harness)),
-        };
-    }
-}

package/dist/cli/menu/apps.d.ts

@@ -1,69 +0,0 @@
-import { type AppCategory, type AppEntry } from '../../shared/apps/index.js';
-import { type Category, type ListItem } from '../tui/index.js';
-import type { ConfigFile } from '../../app/features/settings/index.js';
-import type { Draft } from './settings/draft.js';
-export declare const CUSTOM = "@custom:";
-/** The catalogue has many small categories; the menu shows these few groups so the navigation stays short. */
-export declare const APP_GROUPS: readonly [{
-    readonly id: "editors";
-    readonly label: "Editors & docs";
-    readonly description: "Code and text editors (VS Code is on by default), plus diagrams and document conversion.";
-    readonly members: readonly ["editors", "diagrams"];
-}, {
-    readonly id: "clients";
-    readonly label: "DB & API clients";
-    readonly description: "GUIs for the sandbox databases, tools to send HTTP, REST and GraphQL requests, and to inspect traffic.";
-    readonly members: readonly ["databases", "api", "network"];
-}, {
-    readonly id: "tools";
-    readonly label: "Git & utilities";
-    readonly description: "Git GUIs and terminal UIs, archives, file search and comparing, process tools, and decompilers.";
-    readonly members: readonly ["git", "utilities", "reversing"];
-}, {
-    readonly id: "cli";
-    readonly label: "Command-line & cloud";
-    readonly description: "Small developer tools (JSON, search, builds, media ...) and tools for clouds and Kubernetes.";
-    readonly members: readonly ["cli", "cloud"];
-}, {
-    readonly id: "play";
-    readonly label: "Browsers & games";
-    readonly description: "Browsers for testing web apps, and game engines and editors (they draw with OpenGL on the CPU).";
-    readonly members: readonly ["browsers", "gamedev"];
-}];
-/** The group an app category is shown under. */
-export declare function groupOf(category: AppCategory): string;
-/** The row in Apps that opens the "request an app" issue form (its id is not an app). */
-export declare const REQUEST_APP = "@request-app";
-/** This project's new-issue page on GitHub. */
-export declare const ISSUES_URL = "https://github.com/JoshDiDuca/windows-development-sandbox/issues/new";
-/** The new-issue address with a title and a body to fill in (the page needs no login to show it). */
-export declare function requestAppUrl(): string;
-export declare class AppsModel {
-    private readonly file;
-    private readonly dataPath;
-    constructor(file: ConfigFile, dataPath: string);
-    /** The catalogue entries this file can change (a project cannot change an app that has a setting of its own). */
-    entries(): AppEntry[];
-    categories(): Category[];
-    /** Downloaded already (into this data folder), so the next sandbox starts it without a download. */
-    private installed;
-    private savedInstall;
-    /** Is the entry on in the saved file? */
-    private savedOn;
-    /** Is the entry on once the staged changes are saved? */
-    isOn(entry: AppEntry, draft: Draft): boolean;
-    /** Your own programs (apps.custom), staged or saved. */
-    custom(draft: Draft): Record<string, {
-        name: string;
-        github?: string;
-        url?: string;
-        cli?: boolean;
-    }>;
-    private item;
-    items(draft: Draft): ListItem<string>[];
-    /** Stages the ticks of the list: only what differs from the saved file is kept in the draft. */
-    stageTicks(draft: Draft, ticked: readonly string[]): void;
-}
-/** For notices: "12 apps chosen". */
-export declare function appsSummary(file: ConfigFile): string;
-export declare function appLabel(id: string): string;

package/dist/cli/menu/apps.js

@@ -1,214 +0,0 @@
-// The apps catalogue as data for the Apps tab: every app by category, ticked = installed in every sandbox. VS Code and
-// Windows Terminal are listed too (they have settings of their own, which ticking changes). Ticks are staged in the
-// Draft and written with Ctrl+S, to your config file or (catalogue apps only) the project's .sandbox-config.json.
-import fs from 'node:fs';
-import path from 'node:path';
-import _ from 'lodash';
-import { APPS } from '../../shared/apps/index.js';
-import { Text, Theme } from '../tui/index.js';
-export const CUSTOM = '@custom:';
-/** The catalogue has many small categories; the menu shows these few groups so the navigation stays short. */
-export const APP_GROUPS = [
-    {
-        id: 'editors',
-        label: 'Editors & docs',
-        description: 'Code and text editors (VS Code is on by default), plus diagrams and document conversion.',
-        members: ['editors', 'diagrams'],
-    },
-    {
-        id: 'clients',
-        label: 'DB & API clients',
-        description: 'GUIs for the sandbox databases, tools to send HTTP, REST and GraphQL requests, and to inspect traffic.',
-        members: ['databases', 'api', 'network'],
-    },
-    {
-        id: 'tools',
-        label: 'Git & utilities',
-        description: 'Git GUIs and terminal UIs, archives, file search and comparing, process tools, and decompilers.',
-        members: ['git', 'utilities', 'reversing'],
-    },
-    {
-        id: 'cli',
-        label: 'Command-line & cloud',
-        description: 'Small developer tools (JSON, search, builds, media ...) and tools for clouds and Kubernetes.',
-        members: ['cli', 'cloud'],
-    },
-    {
-        id: 'play',
-        label: 'Browsers & games',
-        description: 'Browsers for testing web apps, and game engines and editors (they draw with OpenGL on the CPU).',
-        members: ['browsers', 'gamedev'],
-    },
-];
-/** The group an app category is shown under. */
-export function groupOf(category) {
-    return APP_GROUPS.find((g) => g.members.includes(category))?.id ?? 'tools';
-}
-const INSTALL = ['apps', 'install'];
-/** The row in Apps that opens the "request an app" issue form (its id is not an app). */
-export const REQUEST_APP = '@request-app';
-/** This project's new-issue page on GitHub. */
-export const ISSUES_URL = 'https://github.com/JoshDiDuca/windows-development-sandbox/issues/new';
-/** The new-issue address with a title and a body to fill in (the page needs no login to show it). */
-export function requestAppUrl() {
-    const body = [
-        '**App name:**',
-        '',
-        '**Where to get it** (GitHub releases page or a direct download link):',
-        '',
-        '**What it is for:**',
-        '',
-        '**Command-line tool or desktop app?**',
-        '',
-        '**Does it need a GPU, a license or an account?**',
-    ].join('\n');
-    const query = [
-        ['title', 'App request: '],
-        ['body', body],
-        ['labels', 'app-request'],
-    ];
-    return ISSUES_URL + '?' + query.map(([k, v]) => k + '=' + encodeURIComponent(v)).join('&');
-}
-export class AppsModel {
-    file;
-    dataPath;
-    constructor(file, dataPath) {
-        this.file = file;
-        this.dataPath = dataPath;
-    }
-    /** The catalogue entries this file can change (a project cannot change an app that has a setting of its own). */
-    entries() {
-        return APPS.filter((a) => !(this.file.isProject && a.setting));
-    }
-    categories() {
-        return [
-            ...APP_GROUPS.map(({ id, label, description }) => ({ id, label, description })),
-            ...(this.file.isProject
-                ? []
-                : [
-                    {
-                        id: 'custom',
-                        label: 'Your own programs',
-                        description: 'Programs you added yourself (c to add or change them).',
-                    },
-                ]),
-        ];
-    }
-    /** Downloaded already (into this data folder), so the next sandbox starts it without a download. */
-    installed(entry) {
-        if (entry.id === 'vscode')
-            return fs.existsSync(path.join(this.dataPath, 'tools', 'vscode', 'Code.exe'));
-        if (entry.id === 'windows-terminal')
-            return fs.existsSync(path.join(this.dataPath, 'tools', 'terminal', 'WindowsTerminal.exe'));
-        return fs.existsSync(path.join(this.dataPath, 'tools', 'apps', entry.id, '.agent-sandbox-app'));
-    }
-    savedInstall() {
-        return ((this.file.isProject ? this.file.valueInFile(INSTALL) : this.file.userConfig().apps.install) ?? []);
-    }
-    /** Is the entry on in the saved file? */
-    savedOn(entry) {
-        return entry.setting
-            ? _.get(this.file.userConfig(), entry.setting) === true
-            : this.savedInstall().includes(entry.id);
-    }
-    /** Is the entry on once the staged changes are saved? */
-    isOn(entry, draft) {
-        if (entry.setting) {
-            const key = entry.setting.split('.');
-            return draft.has(this.file, key) ? draft.value(this.file, key) === true : this.savedOn(entry);
-        }
-        const staged = draft.has(this.file, INSTALL)
-            ? draft.value(this.file, INSTALL)
-            : undefined;
-        return draft.has(this.file, INSTALL) ? (staged ?? []).includes(entry.id) : this.savedOn(entry);
-    }
-    /** Your own programs (apps.custom), staged or saved. */
-    custom(draft) {
-        if (this.file.isProject)
-            return {};
-        const key = ['apps', 'custom'];
-        return (draft.has(this.file, key) ? draft.value(this.file, key) : this.file.userConfig().apps.custom);
-    }
-    item(entry, draft) {
-        const notes = [
-            Theme.muted('Download  ') +
-                '~' +
-                entry.size +
-                ' once, kept in C:\\AgentData\\tools\\' +
-                (entry.setting ? '' : 'apps\\') +
-                entry.id,
-            Theme.muted('Starts    ') +
-                (entry.cli ? 'from a terminal (on PATH)' : 'from the desktop or Start > Sandbox apps'),
-            ...(entry.needs?.includes('mesa')
-                ? [Theme.muted('Graphics  ') + 'OpenGL on the CPU (Mesa) is added for it']
-                : []),
-            ...(entry.fullGitOnly
-                ? [Theme.warn('Needs full git access (Settings > Projects & setup > Git): it pushes with its own git.')]
-                : []),
-            ...(entry.setting ? [Theme.muted('Setting   ') + entry.setting] : []),
-        ];
-        return {
-            value: entry.id,
-            label: entry.name,
-            category: groupOf(entry.category),
-            description: entry.about,
-            details: notes,
-            keywords: entry.id,
-            hint: (this.installed(entry) ? Theme.ok('installed ') : '') + Theme.muted(entry.size),
-            checked: this.isOn(entry, draft),
-        };
-    }
-    items(draft) {
-        return [
-            ...this.entries().map((a) => this.item(a, draft)),
-            ...(this.file.isProject
-                ? []
-                : [
-                    {
-                        value: REQUEST_APP,
-                        label: 'Request an app…',
-                        category: 'custom',
-                        description: 'Not in the list? Press r: your browser opens a prefilled request on GitHub (' + ISSUES_URL + ').',
-                        hint: Theme.muted('press r'),
-                        disabled: 'Press r to open the request form on GitHub.',
-                    },
-                ]),
-            ...Object.entries(this.custom(draft)).map(([id, a]) => ({
-                value: CUSTOM + id,
-                label: a.name,
-                category: 'custom',
-                description: a.github ? 'From the latest ' + a.github + ' release.' : 'From ' + a.url,
-                hint: Theme.muted(a.cli ? 'command line' : 'desktop'),
-                checked: true,
-                disabled: 'Your own programs are always installed; c to change or remove them.',
-            })),
-        ];
-    }
-    /** Stages the ticks of the list: only what differs from the saved file is kept in the draft. */
-    stageTicks(draft, ticked) {
-        for (const entry of this.entries().filter((a) => a.setting)) {
-            const key = entry.setting.split('.');
-            const on = ticked.includes(entry.id);
-            if (on === this.savedOn(entry))
-                draft.unstage(this.file, key);
-            else
-                draft.stage(this.file, key, on);
-        }
-        const wanted = this.entries()
-            .filter((a) => !a.setting && ticked.includes(a.id))
-            .map((a) => a.id);
-        if (_.isEqual([...wanted].sort(), [...this.savedInstall()].sort()))
-            draft.unstage(this.file, INSTALL);
-        else
-            draft.stage(this.file, INSTALL, wanted.length || this.file.isProject ? wanted : undefined);
-    }
-}
-/** For notices: "12 apps chosen". */
-export function appsSummary(file) {
-    const config = file.userConfig();
-    const n = config.apps.install.length + Object.keys(config.apps.custom).length;
-    return n ? n + ' chosen' : 'none chosen';
-}
-export function appLabel(id) {
-    return APPS.find((a) => a.id === id)?.name ?? Text.humanize(id);
-}

package/dist/cli/menu/data-folder.d.ts

@@ -1,18 +0,0 @@
-import type { Context } from '../commands/context.js';
-import type { App } from '../tui/index.js';
-import type { ShellExit } from './shell.js';
-/** The row in Settings and Maintenance. */
-export declare function dataFolderRow(ctx: Context): {
-    label: string;
-    hint: string;
-    description: string;
-};
-export declare class DataFolderFlow {
-    private readonly app;
-    private readonly ctx;
-    constructor(app: App, ctx: Context);
-    /** The command to run (move or use), or undefined when nothing was chosen. */
-    run(): Promise<ShellExit | undefined>;
-    private measure;
-    private decide;
-}

package/dist/cli/menu/data-folder.js

@@ -1,99 +0,0 @@
-// The "Data folder" row and its flow: shows where the saved data is, lets you pick another folder in the path picker,
-// asks whether to move the data or only switch, and hands the command to run on the normal screen (the move prints its
-// progress there).
-import fs from 'node:fs';
-import { humanBytes } from '../../core/disk.js';
-import { describeDuration, describeSize, estimate, holdsData, measureFolder, moveProblem, moveWarning, } from '../../host/storage/index.js';
-/** Measuring for the dialog stops after this long (the size then reads "at least"). */
-const MEASURE_MS = 8000;
-/** The row in Settings and Maintenance. */
-export function dataFolderRow(ctx) {
-    return {
-        label: 'Data folder',
-        hint: ctx.storageRoot,
-        description: 'Where your tools, logins, history and logs are kept between sandboxes. Press Enter to move them to another folder or drive, or to use a different folder.',
-    };
-}
-export class DataFolderFlow {
-    app;
-    ctx;
-    constructor(app, ctx) {
-        this.app = app;
-        this.ctx = ctx;
-    }
-    /** The command to run (move or use), or undefined when nothing was chosen. */
-    async run() {
-        const from = this.ctx.storageRoot;
-        const exists = fs.existsSync(from);
-        const measured = exists ? this.measure(from) : { bytes: 0, files: 0, partial: false };
-        const size = exists && holdsData(from) ? describeSize(measured) : 'nothing in it yet';
-        const to = await this.app.pickPath({
-            path: ['Data folder'],
-            title: 'Choose the folder for your saved data',
-            about: [
-                'Now: ' + from + ' (' + size + ').',
-                'Pick a new or empty folder to move your data there, or a folder that already holds data to use it.',
-            ],
-            initial: from.replace(/[\\/][^\\/]*$/, '\\'),
-            use: 'use this folder',
-            validate: (picked) => {
-                const problem = moveProblem(from, picked, true);
-                return problem ? problem.message : true;
-            },
-        });
-        if (!to)
-            return undefined;
-        return this.decide(from, to, measured, exists);
-    }
-    measure(from) {
-        const before = this.app.status;
-        this.app.status = () => 'Measuring your saved data…';
-        this.app.redraw();
-        try {
-            return measureFolder(from, MEASURE_MS);
-        }
-        finally {
-            this.app.status = before;
-        }
-    }
-    async decide(from, to, measured, exists) {
-        if (to.toLowerCase() === from.toLowerCase())
-            return undefined;
-        const target = holdsData(to);
-        const lines = [];
-        let canMove = exists && holdsData(from) && !target;
-        if (canMove) {
-            const est = estimate(from, to, measured);
-            lines.push('From: ' + from, 'To:   ' + to, 'Size: ' + describeSize(measured));
-            lines.push(est.sameVolume
-                ? 'Time: a few seconds (same drive, nothing is copied)'
-                : 'Time: ' + describeDuration(est.seconds) + ' (copied to another drive)');
-            if (est.freeBytes !== null)
-                lines.push('Free space on the target drive: ' + humanBytes(est.freeBytes));
-            const warning = moveWarning(measured, est);
-            if (warning)
-                lines.push('', warning);
-            if (!est.fits)
-                canMove = false;
-        }
-        else {
-            lines.push(target ? to + ' already holds data, so it is used as it is.' : 'There is nothing in ' + from + ' to move.', 'Your data stays where it is.');
-        }
-        const choice = await this.app.dialog({
-            title: canMove ? 'Move your data to ' + to + '?' : 'Use ' + to + '?',
-            lines: [...lines, '', 'Use without moving: the new folder is used from now on and your old data is left behind.'],
-            choices: [
-                ...(canMove ? [{ value: 'move', label: 'Move data', key: 'm' }] : []),
-                { value: 'use', label: 'Switch without moving', key: 's' },
-                { value: 'cancel', label: 'Cancel', key: 'c' },
-            ],
-            initial: 0,
-            escape: 'cancel',
-        });
-        if (choice === 'move')
-            return { kind: 'run', argv: ['storage', 'move', to, '--yes'] };
-        if (choice === 'use')
-            return { kind: 'run', argv: ['storage', 'use', to, '--yes'] };
-        return undefined;
-    }
-}

package/dist/cli/menu/share-settings.d.ts

@@ -1,21 +0,0 @@
-import type { Context } from '../commands/context.js';
-import { type App } from '../tui/index.js';
-/** The rows' ids in the settings list. */
-export declare const EXPORT_SETTINGS = "@export-settings";
-export declare const IMPORT_SETTINGS = "@import-settings";
-export declare function shareSettingsRows(): {
-    value: string;
-    label: string;
-    hint: string;
-    description: string;
-}[];
-export declare class ShareSettingsFlow {
-    private readonly app;
-    private readonly ctx;
-    constructor(app: App, ctx: Context);
-    /** Your settings as they are on disk now (the menu may have saved changes since it started). */
-    private fresh;
-    /** Returns the notice to show (undefined when cancelled). */
-    export(): Promise<string | undefined>;
-    import(): Promise<string | undefined>;
-}