@duvoai/cli 0.1.0 → 0.2.0

package/dist/commands/runs/start.js

@@ -1,54 +0,0 @@
-import { startRunResponseSchema } from "../../api/run-schemas.js";
-import { httpRequest } from "../../client/client.js";
-import { CliError } from "../../errors.js";
-import { green } from "../../output/green.js";
-import { printJson } from "../../output/json.js";
-import { renderKeyValue } from "../../output/text.js";
-import { requireAuthenticatedConfig } from "../shared/require-auth.js";
-export function registerRunsStart(runs) {
-    runs
-        .command("start")
-        .description("Start a new agent run")
-        .requiredOption("--agent <id>", "ID of the agent to run")
-        .option("--message <text>", "optional initial message to start the run with")
-        .option("--sandbox-id <id>", "optional sandbox ID with pre-uploaded files")
-        .option("--webhook-url <url>", "optional webhook URL to POST run events to")
-        .option("--json", "output raw JSON from the API")
-        .action(async function startAction(options) {
-        const { apiKey, apiBaseUrl } = await requireAuthenticatedConfig(this);
-        const body = {
-            agent_id: options.agent,
-            ...(options.message !== undefined ? { message: options.message } : {}),
-            ...(options.sandboxId !== undefined
-                ? { sandbox_id: options.sandboxId }
-                : {}),
-            ...(options.webhookUrl !== undefined
-                ? { webhook_url: options.webhookUrl }
-                : {}),
-        };
-        const raw = await httpRequest({
-            method: "POST",
-            path: "/v1/runs",
-            apiKey,
-            apiBaseUrl,
-            body,
-        });
-        if (options.json) {
-            printJson(raw);
-            return;
-        }
-        const parsed = startRunResponseSchema.safeParse(raw);
-        if (!parsed.success) {
-            throw new CliError(`Unexpected response from the API: ${parsed.error.message}`);
-        }
-        const { run } = parsed.data;
-        console.log(green("Run started!"));
-        console.log(renderKeyValue([
-            { label: "ID", value: run.id },
-            { label: "Agent", value: run.agent_id },
-            { label: "Build", value: run.build_id },
-            { label: "Status", value: run.status },
-            { label: "Created", value: run.created_at },
-        ]));
-    });
-}

package/dist/commands/runs/stop.d.ts

@@ -1,2 +0,0 @@
-import { type Command } from "commander";
-export declare function registerRunsStop(runs: Command): void;

package/dist/commands/runs/stop.js

@@ -1,41 +0,0 @@
-import { stopRunResponseSchema } from "../../api/run-schemas.js";
-import { httpRequest } from "../../client/client.js";
-import { CliError } from "../../errors.js";
-import { green } from "../../output/green.js";
-import { printJson } from "../../output/json.js";
-import { confirmDestructive } from "../shared/confirm.js";
-import { requireAuthenticatedConfig } from "../shared/require-auth.js";
-export function registerRunsStop(runs) {
-    runs
-        .command("stop <id>")
-        .description("Stop a running agent run")
-        .option("-y, --yes", "skip the confirmation prompt")
-        .option("--json", "output raw JSON from the API")
-        .action(async function stopAction(id, options) {
-        const { apiKey, apiBaseUrl } = await requireAuthenticatedConfig(this);
-        await confirmDestructive({
-            message: `Stop run "${id}"?`,
-            skip: options.yes ?? false,
-        });
-        const raw = await httpRequest({
-            method: "POST",
-            path: `/v1/runs/${encodeURIComponent(id)}/stop`,
-            apiKey,
-            apiBaseUrl,
-        });
-        if (options.json) {
-            printJson(raw);
-            return;
-        }
-        const parsed = stopRunResponseSchema.safeParse(raw);
-        if (!parsed.success) {
-            throw new CliError(`Unexpected response from the API: ${parsed.error.message}`);
-        }
-        const { success, message } = parsed.data;
-        if (!success) {
-            throw new CliError(message ?? `Failed to stop run "${id}".`);
-        }
-        const label = message ?? `Run "${id}" stopped.`;
-        console.log(green(label));
-    });
-}

package/dist/commands/shared/confirm.d.ts

@@ -1,19 +0,0 @@
-type ConfirmOptions = {
-    /** Question shown to the user, e.g. `Remove profile "acme"?`. */
-    message: string;
-    /** Caller already collected consent (e.g. via `--yes`). */
-    skip: boolean;
-};
-/**
- * Prompt for [y/N] confirmation on a destructive action. Skipped when
- * the caller passes `skip: true` (typically from a `--yes` flag).
- *
- * In non-interactive shells (no TTY on stdin) we refuse rather than
- * silently treat piped input as consent. The caller must opt in via
- * `--yes` to proceed without a prompt.
- *
- * Throws instead of calling `process.exit` so the top-level error
- * handler remains the single chokepoint for process termination.
- */
-export declare function confirmDestructive(options: ConfirmOptions): Promise<void>;
-export {};

package/dist/commands/shared/confirm.js

@@ -1,28 +0,0 @@
-import { confirm, isCancel } from "@clack/prompts";
-import { CancelCliError, CliError } from "../../errors.js";
-/**
- * Prompt for [y/N] confirmation on a destructive action. Skipped when
- * the caller passes `skip: true` (typically from a `--yes` flag).
- *
- * In non-interactive shells (no TTY on stdin) we refuse rather than
- * silently treat piped input as consent. The caller must opt in via
- * `--yes` to proceed without a prompt.
- *
- * Throws instead of calling `process.exit` so the top-level error
- * handler remains the single chokepoint for process termination.
- */
-export async function confirmDestructive(options) {
-    if (options.skip) {
-        return;
-    }
-    if (!process.stdin.isTTY) {
-        throw new CliError(`${options.message} Pass --yes to confirm without an interactive prompt.`);
-    }
-    const answer = await confirm({
-        message: options.message,
-        initialValue: false,
-    });
-    if (isCancel(answer) || !answer) {
-        throw new CancelCliError();
-    }
-}

package/dist/commands/shared/pagination.d.ts

@@ -1,8 +0,0 @@
-type ParseLimitOptions = {
-    defaultValue: number;
-    min: number;
-    max: number;
-};
-export declare function parseLimit(raw: string | undefined, { defaultValue, min, max }: ParseLimitOptions): number;
-export declare function parseOffset(raw: string | undefined): number;
-export {};

package/dist/commands/shared/pagination.js

@@ -1,24 +0,0 @@
-import { CliError } from "../../errors.js";
-const POSITIVE_INT = /^\d+$/;
-export function parseLimit(raw, { defaultValue, min, max }) {
-    if (raw === undefined) {
-        return defaultValue;
-    }
-    if (!POSITIVE_INT.test(raw)) {
-        throw new CliError(`--limit must be an integer between ${min} and ${max}`);
-    }
-    const n = Number(raw);
-    if (n < min || n > max) {
-        throw new CliError(`--limit must be an integer between ${min} and ${max}`);
-    }
-    return n;
-}
-export function parseOffset(raw) {
-    if (raw === undefined) {
-        return 0;
-    }
-    if (!POSITIVE_INT.test(raw)) {
-        throw new CliError("--offset must be a non-negative integer");
-    }
-    return Number(raw);
-}

package/dist/commands/shared/profile-flag.d.ts

@@ -1,8 +0,0 @@
-import { type Command } from "commander";
-/**
- * Pulls the global `--profile` option off the root command. Commander
- * merges parent options into `opts()` for subcommands, but the value
- * lives on the root — this helper walks up to find it regardless of how
- * deep the subcommand sits.
- */
-export declare function getProfileFlag(command: Command): string | undefined;

package/dist/commands/shared/profile-flag.js

@@ -1,17 +0,0 @@
-/**
- * Pulls the global `--profile` option off the root command. Commander
- * merges parent options into `opts()` for subcommands, but the value
- * lives on the root — this helper walks up to find it regardless of how
- * deep the subcommand sits.
- */
-export function getProfileFlag(command) {
-    let node = command;
-    while (node) {
-        const opts = node.opts();
-        if (opts.profile) {
-            return opts.profile;
-        }
-        node = node.parent ?? null;
-    }
-    return undefined;
-}

package/dist/commands/shared/require-auth.d.ts

@@ -1,12 +0,0 @@
-import { type Command } from "commander";
-import { type ResolvedConfig } from "../../config/resolve.js";
-export type AuthenticatedConfig = ResolvedConfig & {
-    apiKey: string;
-};
-/**
- * Resolves the effective profile for this invocation and guarantees an
- * API key is present. Intended for every command that hits the API —
- * throws `AuthCliError` (exit code 2) if no key is stored or passed via
- * env, so callers can assume `apiKey` is a non-null string.
- */
-export declare function requireAuthenticatedConfig(command: Command): Promise<AuthenticatedConfig>;

package/dist/commands/shared/require-auth.js

@@ -1,18 +0,0 @@
-import { resolveConfig } from "../../config/resolve.js";
-import { AuthCliError } from "../../errors.js";
-import { getProfileFlag } from "./profile-flag.js";
-/**
- * Resolves the effective profile for this invocation and guarantees an
- * API key is present. Intended for every command that hits the API —
- * throws `AuthCliError` (exit code 2) if no key is stored or passed via
- * env, so callers can assume `apiKey` is a non-null string.
- */
-export async function requireAuthenticatedConfig(command) {
-    const resolved = await resolveConfig({
-        profileFlag: getProfileFlag(command),
-    });
-    if (!resolved.apiKey) {
-        throw new AuthCliError("Not logged in. Run `duvo login` to save an API key.");
-    }
-    return { ...resolved, apiKey: resolved.apiKey };
-}

package/dist/commands/whoami.d.ts

@@ -1,2 +0,0 @@
-import { type Command } from "commander";
-export declare function registerWhoami(program: Command): void;

package/dist/commands/whoami.js

@@ -1,14 +0,0 @@
-import { truncateApiKey } from "../output/format.js";
-import { requireAuthenticatedConfig } from "./shared/require-auth.js";
-export function registerWhoami(program) {
-    program
-        .command("whoami")
-        .description("Print the default profile, truncated API key, and base URL")
-        .action(async function whoamiAction() {
-        const resolved = await requireAuthenticatedConfig(this);
-        const profileLabel = resolved.profileName ?? "(env-only, no stored profile)";
-        console.log(`Profile  ${profileLabel}`);
-        console.log(`API key  ${truncateApiKey(resolved.apiKey)}`);
-        console.log(`Base URL ${resolved.apiBaseUrl}`);
-    });
-}

package/dist/config/defaults.d.ts

@@ -1,3 +0,0 @@
-import { type Config } from "../config/types.js";
-export declare const DEFAULT_API_BASE_URL = "https://api.duvo.ai";
-export declare function emptyConfig(): Config;

package/dist/config/defaults.js

@@ -1,4 +0,0 @@
-export const DEFAULT_API_BASE_URL = "https://api.duvo.ai";
-export function emptyConfig() {
-    return { defaultProfile: null, profiles: {} };
-}

package/dist/config/env.d.ts

@@ -1,17 +0,0 @@
-import { z } from "zod";
-declare const CliEnvSchema: z.ZodObject<{
-    DUVO_PROFILE: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
-    DUVO_API_KEY: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
-    DUVO_API_BASE_URL: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
-}, "strip", z.ZodTypeAny, {
-    DUVO_PROFILE?: string | undefined;
-    DUVO_API_KEY?: string | undefined;
-    DUVO_API_BASE_URL?: string | undefined;
-}, {
-    DUVO_PROFILE?: string | undefined;
-    DUVO_API_KEY?: string | undefined;
-    DUVO_API_BASE_URL?: string | undefined;
-}>;
-export type CliEnv = z.output<typeof CliEnvSchema>;
-export declare function parseCliEnv(env: NodeJS.ProcessEnv): CliEnv;
-export {};

package/dist/config/env.js

@@ -1,13 +0,0 @@
-import { z } from "zod";
-const optionalEnvString = z
-    .string()
-    .optional()
-    .transform((value) => value === undefined || value === "" ? undefined : value);
-const CliEnvSchema = z.object({
-    DUVO_PROFILE: optionalEnvString,
-    DUVO_API_KEY: optionalEnvString,
-    DUVO_API_BASE_URL: optionalEnvString,
-});
-export function parseCliEnv(env) {
-    return CliEnvSchema.parse(env);
-}

package/dist/config/paths.d.ts

@@ -1,2 +0,0 @@
-export declare function getConfigDir(): string;
-export declare function getConfigPath(): string;

package/dist/config/paths.js

@@ -1,14 +0,0 @@
-import { homedir } from "node:os";
-import { join } from "node:path";
-const CONFIG_DIR_NAME = "duvo";
-const CONFIG_FILE_NAME = "config.json";
-export function getConfigDir() {
-    const xdg = process.env.XDG_CONFIG_HOME;
-    if (xdg && xdg.length > 0) {
-        return join(xdg, CONFIG_DIR_NAME);
-    }
-    return join(homedir(), ".config", CONFIG_DIR_NAME);
-}
-export function getConfigPath() {
-    return join(getConfigDir(), CONFIG_FILE_NAME);
-}

package/dist/config/profiles.d.ts

@@ -1,24 +0,0 @@
-import { type Config, type Profile } from "../config/types.js";
-export declare function isValidProfileName(name: string): boolean;
-export declare function assertValidProfileName(name: string): void;
-/**
- * Add (or replace) a profile. The first profile added becomes the
- * default automatically. Returns the updated config without mutating
- * the input.
- */
-export declare function addProfile(config: Config, name: string, profile: Profile): Config;
-/**
- * Remove a profile. If the removed profile was the default, picks
- * another profile alphabetically as the new default, or clears it if
- * none remain.
- */
-export declare function removeProfile(config: Config, name: string): Config;
-export declare function renameProfile(config: Config, oldName: string, newName: string): Config;
-export declare function setDefaultProfile(config: Config, name: string): Config;
-export type ProfileSummary = {
-    name: string;
-    apiKey: string;
-    apiBaseUrl: string;
-    isDefault: boolean;
-};
-export declare function listProfiles(config: Config): readonly ProfileSummary[];

package/dist/config/profiles.js

@@ -1,78 +0,0 @@
-const PROFILE_NAME_PATTERN = /^[a-z0-9._-]+$/;
-const MAX_PROFILE_NAME_LENGTH = 40;
-export function isValidProfileName(name) {
-    if (name.length === 0 || name.length > MAX_PROFILE_NAME_LENGTH) {
-        return false;
-    }
-    return PROFILE_NAME_PATTERN.test(name);
-}
-export function assertValidProfileName(name) {
-    if (!isValidProfileName(name)) {
-        throw new Error(`Invalid profile name "${name}". Use lowercase letters, digits, ` +
-            `".", "-" or "_", max ${MAX_PROFILE_NAME_LENGTH} chars.`);
-    }
-}
-/**
- * Add (or replace) a profile. The first profile added becomes the
- * default automatically. Returns the updated config without mutating
- * the input.
- */
-export function addProfile(config, name, profile) {
-    assertValidProfileName(name);
-    const profiles = { ...config.profiles, [name]: profile };
-    const defaultProfile = config.defaultProfile === null ? name : config.defaultProfile;
-    return { defaultProfile, profiles };
-}
-/**
- * Remove a profile. If the removed profile was the default, picks
- * another profile alphabetically as the new default, or clears it if
- * none remain.
- */
-export function removeProfile(config, name) {
-    if (!(name in config.profiles)) {
-        return config;
-    }
-    const profiles = { ...config.profiles };
-    delete profiles[name];
-    if (config.defaultProfile !== name) {
-        return { defaultProfile: config.defaultProfile, profiles };
-    }
-    const remaining = Object.keys(profiles).sort();
-    const defaultProfile = remaining.length > 0 ? remaining[0] : null;
-    return { defaultProfile, profiles };
-}
-export function renameProfile(config, oldName, newName) {
-    if (!(oldName in config.profiles)) {
-        throw new Error(`Profile "${oldName}" does not exist.`);
-    }
-    if (oldName === newName) {
-        return config;
-    }
-    assertValidProfileName(newName);
-    if (newName in config.profiles) {
-        throw new Error(`Profile "${newName}" already exists.`);
-    }
-    const profiles = { ...config.profiles };
-    profiles[newName] = profiles[oldName];
-    delete profiles[oldName];
-    const defaultProfile = config.defaultProfile === oldName ? newName : config.defaultProfile;
-    return { defaultProfile, profiles };
-}
-export function setDefaultProfile(config, name) {
-    if (!(name in config.profiles)) {
-        throw new Error(`Profile "${name}" does not exist.`);
-    }
-    return { ...config, defaultProfile: name };
-}
-export function listProfiles(config) {
-    return Object.entries(config.profiles)
-        .map(([name, profile]) => {
-        return {
-            name,
-            apiKey: profile.apiKey,
-            apiBaseUrl: profile.apiBaseUrl,
-            isDefault: config.defaultProfile === name,
-        };
-    })
-        .sort((a, b) => a.name.localeCompare(b.name));
-}

package/dist/config/resolve.d.ts

@@ -1,29 +0,0 @@
-import { type CliEnv } from "../config/env.js";
-import { type Config } from "../config/types.js";
-import { AuthCliError } from "../errors.js";
-export type ResolvedConfig = {
-    apiKey: string | null;
-    apiBaseUrl: string;
-    /** Name of the profile we resolved to, or null if we fell through to env-only. */
-    profileName: string | null;
-};
-export type ResolveOptions = {
-    /** From the --profile CLI flag. Takes precedence over env and stored default. */
-    profileFlag?: string | undefined;
-};
-/**
- * Selection precedence:
- *   profile: --profile flag > DUVO_PROFILE env > config.defaultProfile
- *   apiKey:  DUVO_API_KEY env > profile.apiKey
- *   baseUrl: DUVO_API_BASE_URL env > profile.apiBaseUrl > default
- *
- * If --profile is given but unknown, this throws (caller maps to exit 2).
- * DUVO_PROFILE being unset/unknown falls through silently so users can use
- * env overrides without breaking other shells.
- */
-export declare function resolveConfig(options?: ResolveOptions): Promise<ResolvedConfig>;
-export declare function selectEffectiveConfig(config: Config, options: ResolveOptions, env: CliEnv): ResolvedConfig;
-export declare class UnknownProfileError extends AuthCliError {
-    readonly profileName: string;
-    constructor(profileName: string);
-}

package/dist/config/resolve.js

@@ -1,46 +0,0 @@
-import { DEFAULT_API_BASE_URL } from "../config/defaults.js";
-import { parseCliEnv } from "../config/env.js";
-import { readConfig } from "../config/store.js";
-import { AuthCliError } from "../errors.js";
-/**
- * Selection precedence:
- *   profile: --profile flag > DUVO_PROFILE env > config.defaultProfile
- *   apiKey:  DUVO_API_KEY env > profile.apiKey
- *   baseUrl: DUVO_API_BASE_URL env > profile.apiBaseUrl > default
- *
- * If --profile is given but unknown, this throws (caller maps to exit 2).
- * DUVO_PROFILE being unset/unknown falls through silently so users can use
- * env overrides without breaking other shells.
- */
-export async function resolveConfig(options = {}) {
-    const config = await readConfig();
-    return selectEffectiveConfig(config, options, parseCliEnv(process.env));
-}
-export function selectEffectiveConfig(config, options, env) {
-    const profileName = selectProfileName(config, options, env);
-    const profile = profileName ? (config.profiles[profileName] ?? null) : null;
-    const apiKey = env.DUVO_API_KEY ?? profile?.apiKey ?? null;
-    const apiBaseUrl = env.DUVO_API_BASE_URL ?? profile?.apiBaseUrl ?? DEFAULT_API_BASE_URL;
-    return { apiKey, apiBaseUrl, profileName };
-}
-function selectProfileName(config, options, env) {
-    const flag = options.profileFlag;
-    if (flag && flag.length > 0) {
-        if (!(flag in config.profiles)) {
-            throw new UnknownProfileError(flag);
-        }
-        return flag;
-    }
-    if (env.DUVO_PROFILE && env.DUVO_PROFILE in config.profiles) {
-        return env.DUVO_PROFILE;
-    }
-    return config.defaultProfile;
-}
-export class UnknownProfileError extends AuthCliError {
-    profileName;
-    constructor(profileName) {
-        super(`Profile "${profileName}" does not exist. Run \`duvo profiles list\` to see available profiles.`);
-        this.profileName = profileName;
-        this.name = "UnknownProfileError";
-    }
-}

package/dist/config/store.d.ts

@@ -1,4 +0,0 @@
-import { type Config } from "../config/types.js";
-export declare function readConfig(): Promise<Config>;
-export declare function writeConfig(config: Config): Promise<void>;
-export declare function deleteConfig(): Promise<boolean>;

package/dist/config/store.js

@@ -1,94 +0,0 @@
-import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
-import { dirname } from "node:path";
-import { DEFAULT_API_BASE_URL, emptyConfig } from "../config/defaults.js";
-import { getConfigPath } from "../config/paths.js";
-const FILE_MODE = 0o600;
-const DIR_MODE = 0o700;
-export async function readConfig() {
-    const path = getConfigPath();
-    try {
-        const raw = await readFile(path, "utf8");
-        const parsed = JSON.parse(raw);
-        return normalizeConfig(parsed);
-    }
-    catch (error) {
-        if (isNotFound(error)) {
-            return emptyConfig();
-        }
-        throw error;
-    }
-}
-export async function writeConfig(config) {
-    const path = getConfigPath();
-    await mkdir(dirname(path), { recursive: true, mode: DIR_MODE });
-    await writeFile(path, JSON.stringify(config, null, 2), {
-        mode: FILE_MODE,
-        encoding: "utf8",
-    });
-}
-export async function deleteConfig() {
-    const path = getConfigPath();
-    try {
-        await rm(path);
-        return true;
-    }
-    catch (error) {
-        if (isNotFound(error)) {
-            return false;
-        }
-        throw error;
-    }
-}
-/**
- * Accepts the legacy single-profile shape ({ apiKey, apiBaseUrl }) and
- * migrates it into the named-profile shape under the "default" name. Any
- * fields we don't recognize are dropped.
- */
-function normalizeConfig(parsed) {
-    if (parsed === null || typeof parsed !== "object") {
-        return emptyConfig();
-    }
-    const record = parsed;
-    // Legacy single-profile migration.
-    if (typeof record.apiKey === "string" &&
-        record.profiles === undefined &&
-        record.defaultProfile === undefined) {
-        const apiBaseUrl = typeof record.apiBaseUrl === "string"
-            ? record.apiBaseUrl
-            : DEFAULT_API_BASE_URL;
-        return {
-            defaultProfile: "default",
-            profiles: {
-                default: { apiKey: record.apiKey, apiBaseUrl },
-            },
-        };
-    }
-    const profiles = {};
-    const rawProfiles = record.profiles && typeof record.profiles === "object"
-        ? record.profiles
-        : {};
-    for (const [name, value] of Object.entries(rawProfiles)) {
-        if (value === null || typeof value !== "object") {
-            continue;
-        }
-        const profile = value;
-        if (typeof profile.apiKey !== "string") {
-            continue;
-        }
-        const apiBaseUrl = typeof profile.apiBaseUrl === "string"
-            ? profile.apiBaseUrl
-            : DEFAULT_API_BASE_URL;
-        profiles[name] = { apiKey: profile.apiKey, apiBaseUrl };
-    }
-    const defaultProfile = typeof record.defaultProfile === "string" &&
-        record.defaultProfile in profiles
-        ? record.defaultProfile
-        : null;
-    return { defaultProfile, profiles };
-}
-function isNotFound(error) {
-    return (typeof error === "object" &&
-        error !== null &&
-        "code" in error &&
-        error.code === "ENOENT");
-}

package/dist/config/types.d.ts

@@ -1,8 +0,0 @@
-export type Profile = {
-    apiKey: string;
-    apiBaseUrl: string;
-};
-export type Config = {
-    defaultProfile: string | null;
-    profiles: Record<string, Profile>;
-};

package/dist/config/types.js

@@ -1 +0,0 @@
-export {};

package/dist/errors.d.ts

@@ -1,22 +0,0 @@
-export declare const EXIT_CODE: {
-    readonly SUCCESS: 0;
-    readonly GENERIC: 1;
-    readonly AUTH: 2;
-    readonly NOT_FOUND: 3;
-};
-export type ExitCode = (typeof EXIT_CODE)[keyof typeof EXIT_CODE];
-export declare class CliError extends Error {
-    readonly exitCode: ExitCode;
-    constructor(message: string, exitCode?: ExitCode);
-}
-export declare class AuthCliError extends CliError {
-    constructor(message: string);
-}
-export declare class NotFoundCliError extends CliError {
-    constructor(message: string);
-}
-/** Signals a cooperative user-driven cancel (Ctrl-C, answering "no"). */
-export declare class CancelCliError extends CliError {
-    constructor(message?: string);
-}
-export declare function handleCliError(error: unknown): never;