@duyquangnvx/agent-cli 0.27.0 → 0.28.0

package/dist/run-command.js

@@ -1,27 +1,18 @@
 import { installOf } from "./built-ins/install/install.js";
-import { poll, realClock } from "./clock.js";
-import { checkedCodes } from "./command-errors.js";
-import { changedArgv, commandLineOf } from "./command-line/invocation.js";
-import { knownFlags, parseCommand, stdinArgOf, } from "./command-line/parse-input.js";
+import { commandLineOf } from "./command-line/invocation.js";
+import { parseCommand } from "./command-line/parse-input.js";
 import { commandLabel } from "./command-spec.js";
-import { fileErrorOf } from "./context/errno.js";
-import { classifiedFiles, realFiles } from "./context/files.js";
 import { RunControl } from "./context/interrupts.js";
 import { checkOperator } from "./context/operator.js";
-import { outputsGuard } from "./context/outputs.js";
 import { projectOf } from "./context/project.js";
-import { envFileOf, isNeeded, secretOf } from "./context/secrets.js";
 import { noSideTask, startSideTask } from "./context/side-task.js";
-import { contextSpawn, contextSpawnDetached, realSpawn, realSpawnDetached, } from "./context/spawn.js";
 import { spillTo } from "./context/spill.js";
 import { isTerminal, readingLine, readStdin, stdinStalled } from "./context/stdin.js";
-import { cliErrorOf } from "./error-table.js";
 import { isDebug, traceOf } from "./errors.js";
 import { dataOutcome, execute } from "./execute.js";
 import { manifestAt } from "./manifest.js";
-import { commandResult, errorResult, noticeLine, progressLine, STOPPED_RESULT, startedOutput, } from "./output.js";
-import { packageRootOf } from "./package-root.js";
-import { buildStamp } from "./version.js";
+import { commandResult, errorResult, STOPPED_RESULT, startedOutput, } from "./output.js";
+import { contextOf, once, runScopeOf } from "./run-scope.js";
 function stdinNeverEndedHint(callerLine) {
     return `stdin never ended: pipe the text into \`${callerLine}\`, or redirect a file into it`;
 }
@@ -30,108 +21,19 @@ function runDeadlineAdvice(resumed, pipedLine) {
         ? { hint: stdinNeverEndedHint(pipedLine) }
         : { hint: "run the Next step to continue the work", next: [resumed] };
 }
-function selfOf(name, bin) {
-    return bin === undefined ? [name] : [process.execPath, ...process.execArgv, bin];
-}
-const unfakedSpawnDetached = async () => {
-    throw new Error("runCli was given a fake spawn but no spawnDetached: pass spawnDetached to runCli, so the test starts no real child");
-};
-// A test that fakes `spawn` expects no real child, detached ones included.
-function spawnDetachedOf({ spawn, spawnDetached }) {
-    if (spawnDetached !== undefined)
-        return spawnDetached;
-    return spawn === undefined ? realSpawnDetached : unfakedSpawnDetached;
-}
-function portsOf(cli, replacement) {
-    if (replacement !== undefined)
-        return () => replacement;
-    return cli.ports ?? (() => ({}));
-}
-function portsBaseOf(scope, signal) {
-    const { cli, options, packageRoot, progress, fileError, rerun, clock, files } = scope;
-    const { cwd, env } = options;
-    const envFile = envFileOf(cli.name, env);
-    return {
-        cwd,
-        env,
-        packageRoot,
-        progress,
-        secret: (name) => secretOf({ envFile, env, fileError }, name),
-        envFile,
-        fileError,
-        version: cli.version,
-        build: buildStamp(),
-        self: selfOf(cli.name, options.bin),
-        signal,
-        clock,
-        files,
-        spawn: contextSpawn(options.spawn ?? realSpawn, { cwd, env, signal }, { fileError, rerun }),
-        spawnDetached: contextSpawnDetached(spawnDetachedOf(options), { cwd, env, signal }, { fileError, rerun }),
-    };
-}
-function contextOf(portsBase, control, parts) {
-    const { ports, project, force, dryRun, secrets = [], rerun, deliver, notice } = parts;
-    const declared = new Map(secrets.map((declaration) => [declaration.name, declaration]));
-    function secret(name) {
-        const declaration = declared.get(name);
-        // Only a cast reaches an undeclared name, and only a `.env` edited mid-run a missing value.
-        if (declaration === undefined) {
-            throw new Error(`ctx.secret("${name}") names a Secret the Command does not declare`);
-        }
-        const found = portsBase.secret(name);
-        if (found === undefined && isNeeded(declaration)) {
-            throw new Error(`ctx.secret("${name}") found no value`);
-        }
-        return found;
-    }
-    return {
-        ...portsBase,
-        secret,
-        fail: cliErrorOf,
-        deadline: (ms, options) => control.deadline(ms, options),
-        runToEnd: (name, work) => control.runToEnd(name, work),
-        // Built on first read, so a factory that throws fails only what needs the ports, never `doctor`.
-        get ports() {
-            return ports();
-        },
-        project,
-        force,
-        dryRun,
-        rerun,
-        poll: (check, { intervalMs, signal: stop }) => poll(portsBase.clock, check, intervalMs, stop === undefined ? control.signal : AbortSignal.any([control.signal, stop])),
-        deliver,
-        notice,
-    };
-}
-/** Leaves the Side task running, so the caller writes the result before it waits for it. */
+/**
+ * Leaves the Side task running, so the caller writes the result before it waits for it.
+ *
+ * A gate that needs no `ctx` (operator, parse, Project file) runs here; one that does (tools,
+ * Secrets, the Plan's) runs in `execute`, after the Notices, so a failing run still delivers them.
+ */
 export async function runCommand(cli, routed, options, write, baseFormat) {
     const { command, commandLine, builtIn } = routed.spec;
     const { cwd, env } = options;
-    const clock = options.clock ?? realClock;
-    const files = options.files ?? realFiles();
     const stdin = options.stdin ?? "";
-    const platform = options.platform ?? process.platform;
-    const ports = portsOf(cli, options.ports);
-    const packageRoot = packageRootOf(options.bin, cwd);
-    const progress = (message) => write.stderr(progressLine(message, routed.json));
-    const invocation = {
-        ...baseFormat.invocation,
-        flags: knownFlags(routed.spec),
-        stdinArg: stdinArgOf(routed),
-    };
-    const rerunOf = (change) => ({
-        kind: "rerun",
-        words: changedArgv(invocation, change),
-        stdinArg: invocation.stdinArg,
-    });
+    const scope = runScopeOf(cli, routed, options, write, baseFormat.invocation);
+    const { invocation, rerun: rerunOf, fileError, clock, outputs, progress, platform } = scope;
     const rerun = rerunOf();
-    const fileError = fileErrorOf({ rerun, env, platform });
-    const format = {
-        ...baseFormat,
-        bugs: () => manifestAt(packageRoot).bugs,
-        json: routed.json,
-        invocation,
-    };
     // A stdin that never ended was fed by the caller's own pipe, so its hint names no file to redirect.
     const pipedLine = commandLineOf({ ...invocation, stdinArg: undefined });
     // Set once the input is parsed; a deadline before that can only have cut off the stdin read.
@@ -150,9 +52,17 @@ export async function runCommand(cli, routed, options, write, baseFormat) {
                 advice: () => runDeadlineAdvice(resumed, pipedLine),
             },
     });
-    const failed = (error, finishSideTask) => {
+    const format = {
+        ...baseFormat,
+        command: routed.spec,
+        control,
+        bugs: () => manifestAt(scope.packageRoot).bugs,
+        json: routed.json,
+        invocation,
+    };
+    const failed = async (error, finishSideTask) => {
         control.close();
-        return { result: errorResult(error, format), finishSideTask };
+        return { result: await errorResult(error, format), finishSideTask };
     };
     let parsed;
     try {
@@ -171,21 +81,9 @@ export async function runCommand(cli, routed, options, write, baseFormat) {
     }
     const { input, flags } = parsed;
     resumed = command.deadline?.resume(input, rerunOf);
-    const outputs = outputsGuard(classifiedFiles(files, { cwd, fileError }), cwd);
-    const scope = {
-        cli,
-        options,
-        packageRoot,
-        progress,
-        fileError,
-        rerun,
-        clock,
-        files: outputs.files,
-    };
-    const portsBase = portsBaseOf(scope, control.signal);
     const finishSideTask = startSideTask(builtIn ? undefined : cli.sideTask?.bind(cli), (sideSignal) => {
-        const sideBase = portsBaseOf(scope, sideSignal);
-        const sidePorts = once(() => ports(sideBase));
+        const sideBase = scope.portsBase(sideSignal);
+        const sidePorts = once(() => scope.ports(sideBase));
         return {
             ...sideBase,
             command: routed.spec.path,
@@ -214,14 +112,10 @@ export async function runCommand(cli, routed, options, write, baseFormat) {
     }
     // Parsed only when printed, so a Command that catches around `deliver` cannot hide a rejection.
     let delivered;
-    const ctx = contextOf(portsBase, control, {
-        ports: once(() => ports(portsBase)),
+    const ctx = contextOf(scope, control, {
+        command,
+        flags,
         project,
-        force: flags.force,
-        dryRun: flags.dryRun,
-        secrets: command.secrets,
-        rerun: rerunOf,
-        notice: (text) => write.stderr(noticeLine(text, routed.json)),
         deliver: (data) => {
             delivered = () => dataOutcome(command, data, commandLine);
         },
@@ -239,18 +133,14 @@ export async function runCommand(cli, routed, options, write, baseFormat) {
     try {
         const outcome = await control.settle(
         // The Notices come first, so they reach the caller even when the Command fails.
-        noticesOf(cli, { builtIn, bin: options.bin, node: options.node }, ctx).then(() => execute(command, input, ctx, {
-            dryRun: flags.dryRun,
-            confirm: flags.confirm,
-            yes: flags.yes,
-            page: flags.page,
+        noticesOf(cli, { builtIn, bin: options.bin, node: options.node, platform }, ctx).then(() => execute(command, input, ctx, {
+            flags,
             commandLine,
             started: async (outcome) => {
                 write.stdout(await startedOutput(outcome, format, spill));
                 served = true;
             },
-            files,
-            guardOutputs: outputs.guard,
+            outputs,
         })));
         // A serve Command that ended itself printed its data when it started.
         if (served)
@@ -264,7 +154,7 @@ export async function runCommand(cli, routed, options, write, baseFormat) {
         }
         settled = {
             ok: false,
-            error: checkedCodes(control.errorAfter(error), routed.spec, cli),
+            error,
             delivered,
         };
     }
@@ -273,23 +163,6 @@ export async function runCommand(cli, routed, options, write, baseFormat) {
         finishSideTask,
     };
 }
-/** `build` runs on the first call; later calls give its value or throw its error again. */
-function once(build) {
-    let outcome;
-    return () => {
-        if (outcome === undefined) {
-            try {
-                outcome = { ok: true, value: build() };
-            }
-            catch (error) {
-                outcome = { ok: false, error };
-            }
-        }
-        if (outcome.ok)
-            return outcome.value;
-        throw outcome.error;
-    };
-}
 async function noticesOf(cli, launch, ctx) {
     await installOf(cli).notice(launch, ctx);
 }

package/dist/run-command.js.map

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

package/dist/run-options.d.ts

@@ -41,8 +41,11 @@ export interface RunOptions<Ports = NoPorts> {
     /** What an arg given `-` reads; absent, it reads an empty text. */
     readonly stdin?: StdinSource;
     /**
-     * Replaces `process.platform` in picking the wording of hints, such as `PERMISSION_DENIED`'s and
-     * how to end stdin, for a test of the Windows wording.
+     * Replaces `process.platform` wherever the Runtime reads it: the wording of hints, such as
+     * `PERMISSION_DENIED`'s and how to end stdin, which file a declared tool is on `PATH` (Windows
+     * adds `PATHEXT`), and npm's file and folders in the Built-in Commands. A test passes `"win32"`
+     * to run the Windows branches on any OS; starting a real child and retrying a real file rename
+     * still follow the host.
      */
     readonly platform?: NodeJS.Platform;
 }

package/dist/run-scope.d.ts

@@ -0,0 +1,35 @@
+import { type Clock } from "./clock.js";
+import { type Invocation } from "./command-line/invocation.js";
+import { type StandardValues } from "./command-line/parse-input.js";
+import type { CommandRoute } from "./command-line/route.js";
+import { type FileError } from "./context/errno.js";
+import type { RunControl } from "./context/interrupts.js";
+import { type Outputs } from "./context/outputs.js";
+import type { Context, PortsBase, Project } from "./context.js";
+import type { Cli, Command } from "./define.js";
+import type { RunSettings, Writers } from "./run-options.js";
+/** What one Command run shares between its `ctx`, its Side task and its output. */
+export interface RunScope {
+    readonly invocation: Invocation;
+    readonly rerun: Context["rerun"];
+    readonly fileError: FileError;
+    readonly clock: Clock;
+    readonly platform: NodeJS.Platform;
+    readonly outputs: Outputs;
+    readonly progress: (message: string) => void;
+    readonly notice: (text: string) => void;
+    readonly packageRoot: string;
+    /** The CLI's ports factory, or the test's replacement. */
+    readonly ports: (base: PortsBase) => unknown;
+    portsBase(signal: AbortSignal): PortsBase;
+}
+export declare function runScopeOf(cli: Cli, routed: CommandRoute, settings: RunSettings<unknown>, write: Writers, baseInvocation: Invocation): RunScope;
+export interface Parsed {
+    readonly command: Command;
+    readonly flags: StandardValues;
+    readonly project: Project | undefined;
+    readonly deliver: Context["deliver"];
+}
+export declare function contextOf(scope: RunScope, control: RunControl, { command, flags, project, deliver }: Parsed): Context;
+/** `build` runs on the first call; later calls give its value or throw its error again. */
+export declare function once<T>(build: () => T): () => T;

package/dist/run-scope.js

@@ -0,0 +1,138 @@
+import { poll, realClock } from "./clock.js";
+import { changedArgv } from "./command-line/invocation.js";
+import { knownFlags, stdinArgOf } from "./command-line/parse-input.js";
+import { fileErrorOf } from "./context/errno.js";
+import { realFiles } from "./context/files.js";
+import { outputsOf } from "./context/outputs.js";
+import { envFileOf, isNeeded, secretOf } from "./context/secrets.js";
+import { contextSpawn, contextSpawnDetached, realSpawn, realSpawnDetached, } from "./context/spawn.js";
+import { cliErrorOf } from "./error-table.js";
+import { noticeLine, progressLine } from "./output.js";
+import { packageRootOf } from "./package-root.js";
+import { buildStamp } from "./version.js";
+function selfOf(name, bin) {
+    return bin === undefined ? [name] : [process.execPath, ...process.execArgv, bin];
+}
+const unfakedSpawnDetached = async () => {
+    throw new Error("runCli was given a fake spawn but no spawnDetached: pass spawnDetached to runCli, so the test starts no real child");
+};
+// A test that fakes `spawn` expects no real child, detached ones included.
+function spawnDetachedOf({ spawn, spawnDetached }) {
+    if (spawnDetached !== undefined)
+        return spawnDetached;
+    return spawn === undefined ? realSpawnDetached : unfakedSpawnDetached;
+}
+function portsOf(cli, replacement) {
+    if (replacement !== undefined)
+        return () => replacement;
+    return cli.ports ?? (() => ({}));
+}
+export function runScopeOf(cli, routed, settings, write, baseInvocation) {
+    const { cwd, env } = settings;
+    const clock = settings.clock ?? realClock;
+    const platform = settings.platform ?? process.platform;
+    const invocation = {
+        ...baseInvocation,
+        flags: knownFlags(routed.spec),
+        stdinArg: stdinArgOf(routed),
+    };
+    const rerun = (change) => ({
+        kind: "rerun",
+        words: changedArgv(invocation, change),
+        stdinArg: invocation.stdinArg,
+    });
+    const fileError = fileErrorOf({
+        rerun: rerun(),
+        env,
+        platform,
+    });
+    const outputs = outputsOf(settings.files ?? realFiles(), { cwd, fileError });
+    const packageRoot = packageRootOf(settings.bin, cwd);
+    const progress = (message) => write.stderr(progressLine(message, routed.json));
+    const envFile = envFileOf(cli.name, env);
+    const spawning = { fileError, rerun: rerun() };
+    return {
+        invocation,
+        rerun,
+        fileError,
+        clock,
+        platform,
+        outputs,
+        progress,
+        notice: (text) => write.stderr(noticeLine(text, routed.json)),
+        packageRoot,
+        ports: portsOf(cli, settings.ports),
+        portsBase: (signal) => ({
+            cwd,
+            env,
+            platform,
+            packageRoot,
+            progress,
+            secret: (name) => secretOf({ envFile, env, fileError }, name),
+            envFile,
+            fileError,
+            version: cli.version,
+            build: buildStamp(),
+            self: selfOf(cli.name, settings.bin),
+            signal,
+            clock,
+            files: outputs.files,
+            spawn: contextSpawn(settings.spawn ?? realSpawn, { cwd, env, signal }, spawning),
+            spawnDetached: contextSpawnDetached(spawnDetachedOf(settings), { cwd, env, signal }, spawning),
+        }),
+    };
+}
+export function contextOf(scope, control, { command, flags, project, deliver }) {
+    const portsBase = scope.portsBase(control.signal);
+    const ports = once(() => scope.ports(portsBase));
+    // The only Secrets `ctx.secret` reads.
+    const declared = new Map((command.secrets ?? []).map((declaration) => [declaration.name, declaration]));
+    function secret(name) {
+        const declaration = declared.get(name);
+        // Only a cast reaches an undeclared name, and only a `.env` edited mid-run a missing value.
+        if (declaration === undefined) {
+            throw new Error(`ctx.secret("${name}") names a Secret the Command does not declare`);
+        }
+        const found = portsBase.secret(name);
+        if (found === undefined && isNeeded(declaration)) {
+            throw new Error(`ctx.secret("${name}") found no value`);
+        }
+        return found;
+    }
+    return {
+        ...portsBase,
+        secret,
+        fail: cliErrorOf,
+        deadline: (ms, options) => control.deadline(ms, options),
+        runToEnd: (name, work) => control.runToEnd(name, work),
+        // Built on first read, so a factory that throws fails only what needs the ports, never `doctor`.
+        get ports() {
+            return ports();
+        },
+        project,
+        force: flags.force,
+        dryRun: flags.dryRun,
+        rerun: scope.rerun,
+        poll: (check, { intervalMs, signal: stop }) => poll(portsBase.clock, check, intervalMs, stop === undefined ? control.signal : AbortSignal.any([control.signal, stop])),
+        deliver,
+        notice: scope.notice,
+    };
+}
+/** `build` runs on the first call; later calls give its value or throw its error again. */
+export function once(build) {
+    let outcome;
+    return () => {
+        if (outcome === undefined) {
+            try {
+                outcome = { ok: true, value: build() };
+            }
+            catch (error) {
+                outcome = { ok: false, error };
+            }
+        }
+        if (outcome.ok)
+            return outcome.value;
+        throw outcome.error;
+    };
+}
+//# sourceMappingURL=run-scope.js.map

package/dist/run-scope.js.map

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

package/dist/runtime-codes.d.ts

@@ -1,3 +1,138 @@
+import type { ErrorTable } from "./error-table.js";
+import type { ExitClass } from "./exit-classes.js";
+export declare const DOCTOR_PROBLEMS = "DOCTOR_PROBLEMS";
+export declare const NOT_GLOBAL_INSTALL = "NOT_GLOBAL_INSTALL";
+export declare const NOT_ON_PATH = "NOT_ON_PATH";
+export declare const REGISTRY_UNREACHABLE = "REGISTRY_UNREACHABLE";
+export declare const REGISTRY_AUTH = "REGISTRY_AUTH";
+export declare const INSTALL_FAILED = "INSTALL_FAILED";
+export declare const NPM_FAILED = "NPM_FAILED";
+export declare const NO_LATEST = "NO_LATEST";
+/**
+ * The Runtime codes only some Commands reach: each Command that throws one, Built-in or the CLI's
+ * own, declares it in `errors`, as it does a code of the CLI's Error table.
+ */
+export declare const declaredRuntimeErrors: {
+    readonly DOCTOR_PROBLEMS: {
+        readonly class: "operator";
+    };
+    readonly NOT_GLOBAL_INSTALL: {
+        readonly class: "operator";
+    };
+    readonly NOT_ON_PATH: {
+        readonly class: "operator";
+    };
+    readonly REGISTRY_UNREACHABLE: {
+        readonly class: "operator";
+    };
+    readonly REGISTRY_AUTH: {
+        readonly class: "operator";
+    };
+    readonly INSTALL_FAILED: {
+        readonly class: "operator";
+    };
+    readonly NPM_FAILED: {
+        readonly class: "operator";
+    };
+    readonly NO_LATEST: {
+        readonly class: "source";
+    };
+};
+/** The Runtime's own Error table: every code it fails a run with, and the class that must act. */
+export declare const runtimeErrors: {
+    readonly INVALID_INPUT: {
+        readonly class: "caller";
+    };
+    readonly UNKNOWN_OPTION: {
+        readonly class: "caller";
+    };
+    readonly UNKNOWN_COMMAND: {
+        readonly class: "caller";
+    };
+    readonly UNKNOWN_FIELD: {
+        readonly class: "caller";
+    };
+    readonly CONFIRMATION_REQUIRED: {
+        readonly class: "caller";
+    };
+    readonly CONFIRMATION_MISMATCH: {
+        readonly class: "caller";
+    };
+    readonly NOT_CONFIRMED: {
+        readonly class: "operator";
+    };
+    readonly NEEDS_OPERATOR: {
+        readonly class: "operator";
+    };
+    readonly OUTPUT_EXISTS: {
+        readonly class: "caller";
+    };
+    readonly STDIN_STALLED: {
+        readonly class: "caller";
+    };
+    readonly INTERRUPTED: {
+        readonly class: "interrupted";
+    };
+    readonly DEADLINE_EXCEEDED: {
+        readonly class: "wait";
+    };
+    readonly INTERNAL: {
+        readonly class: "bug";
+    };
+    readonly PERMISSION_DENIED: {
+        readonly class: "operator";
+    };
+    readonly DISK_FULL: {
+        readonly class: "operator";
+    };
+    readonly NOT_FOUND: {
+        readonly class: "caller";
+    };
+    readonly ALREADY_EXISTS: {
+        readonly class: "caller";
+    };
+    readonly NOT_A_FILE: {
+        readonly class: "caller";
+    };
+    readonly TOOL_FAILED: {
+        readonly class: "operator";
+    };
+    readonly TOOL_MISSING: {
+        readonly class: "operator";
+    };
+    readonly SECRET_MISSING: {
+        readonly class: "operator";
+    };
+    readonly PROJECT_INVALID: {
+        readonly class: "operator";
+    };
+    readonly DOCTOR_PROBLEMS: {
+        readonly class: "operator";
+    };
+    readonly NOT_GLOBAL_INSTALL: {
+        readonly class: "operator";
+    };
+    readonly NOT_ON_PATH: {
+        readonly class: "operator";
+    };
+    readonly REGISTRY_UNREACHABLE: {
+        readonly class: "operator";
+    };
+    readonly REGISTRY_AUTH: {
+        readonly class: "operator";
+    };
+    readonly INSTALL_FAILED: {
+        readonly class: "operator";
+    };
+    readonly NPM_FAILED: {
+        readonly class: "operator";
+    };
+    readonly NO_LATEST: {
+        readonly class: "source";
+    };
+};
+export type RuntimeCode = keyof typeof runtimeErrors;
+export type DeclaredRuntimeErrors = typeof declaredRuntimeErrors;
 /** Every code the Runtime fails a run with, keyed by itself, to catch or assert one. */
 export declare const runtimeCodes: {
     readonly INVALID_INPUT: "INVALID_INPUT";
@@ -31,4 +166,8 @@ export declare const runtimeCodes: {
     readonly NPM_FAILED: "NPM_FAILED";
     readonly NO_LATEST: "NO_LATEST";
 };
-export type RuntimeCode = (typeof runtimeCodes)[keyof typeof runtimeCodes];
+export declare const anyCommandClasses: readonly ExitClass[];
+export declare function isRuntimeCode(code: string): code is RuntimeCode;
+export declare function isDeclaredRuntimeCode(code: string): code is keyof DeclaredRuntimeErrors;
+/** Whether a Command or `doctor` row throwing `code` must declare it: a code of `table`, or a Runtime one only some reach. */
+export declare function mustDeclare(code: string, table: ErrorTable): boolean;