@ai21/gateway 0.5.3

package/dist/report.js

@@ -0,0 +1,214 @@
+import { DEFAULT_URLS, isInsecureGateway } from "./args.js";
+import { EXIT } from "./result.js";
+/**
+ * Outcome name → exit code. This is the map `--json` consumers branch on, so the
+ * numbers are a contract: they may gain entries but never change meaning.
+ */
+export const EXIT_FOR = {
+    created: EXIT.OK,
+    updated: EXIT.OK,
+    unchanged: EXIT.OK,
+    conflict: EXIT.CONFLICT,
+    malformed: EXIT.MALFORMED,
+    failed: EXIT.INTERNAL,
+};
+/**
+ * `uninstall` outcome → exit code. Same contract as EXIT_FOR: entries may be added,
+ * meanings never change. Actionable refusals share CONFLICT; the two
+ * "not-there" cases get their own codes so a script can tell them apart.
+ */
+export const EXIT_FOR_REVERT = {
+    reverted: EXIT.OK,
+    restored: EXIT.OK,
+    "not-configured": EXIT.NOT_CONFIGURED,
+    "agent-mismatch": EXIT.CONFLICT,
+    drifted: EXIT.CONFLICT,
+    "no-backup": EXIT.NO_BACKUP,
+    malformed: EXIT.MALFORMED,
+    failed: EXIT.INTERNAL,
+};
+function revertLine(outcome) {
+    switch (outcome.kind) {
+        case "reverted": {
+            const parts = [
+                outcome.restored.length > 0 ? `restored ${outcome.restored.join(", ")} to previous values` : undefined,
+                outcome.removed.length > 0 ? `removed ${outcome.removed.join(", ")}` : undefined,
+            ].filter((part) => part !== undefined);
+            return `Reverted ${outcome.path} — ${parts.join("; ")}`;
+        }
+        case "restored":
+            return `Restored ${outcome.path} from ${outcome.backup}`;
+        case "not-configured":
+            return `Nothing to revert — ${outcome.path} does not carry this tool's settings.`;
+        case "agent-mismatch":
+            return `${outcome.path} is configured for agent '${outcome.actual}', not '${outcome.expected}'.`;
+        case "drifted":
+            return `${outcome.path} has changed since it was written.`;
+        case "no-backup":
+            return `No backup to restore from: ${outcome.backup} does not exist.`;
+        case "malformed":
+            return `Refusing to edit ${outcome.path}: ${outcome.reason}.`;
+        case "failed":
+            return `Could not update ${outcome.path}: ${outcome.reason}.`;
+    }
+}
+/** Human-only detail: what the user can do about a refusal. */
+function revertDetail(outcome) {
+    switch (outcome.kind) {
+        case "reverted":
+            // Said out loud because it is a silent partial failure otherwise: the keys
+            // are gone but whatever they held beforehand could not be recovered.
+            return outcome.backupUnreadable
+                ? `The backup could not be read, so any values these keys held before could not be restored.\n`
+                : "";
+        case "drifted":
+            return ("Restoring the backup would discard those changes. Nothing was written.\n" +
+                "Re-run with --yes to restore anyway, or without --from-backup to remove only this tool's keys.\n");
+        case "agent-mismatch":
+            return "Nothing was written. Re-run without --agent-id to revert whatever is there.\n";
+        case "no-backup":
+            return "Re-run without --from-backup to remove only this tool's keys.\n";
+        case "malformed":
+            return "Nothing was written. Fix or move the file, then re-run.\n";
+        case "failed":
+            return "The existing file was left unchanged.\n";
+        default:
+            return "";
+    }
+}
+export function reportRevert(outcome, json) {
+    const code = EXIT_FOR_REVERT[outcome.kind];
+    if (json) {
+        const { kind, path, ...rest } = outcome;
+        const payload = { ok: code === EXIT.OK, outcome: kind, exitCode: code, path, ...rest };
+        return { code, out: `${JSON.stringify(payload, null, 2)}\n`, err: "" };
+    }
+    const body = `${revertLine(outcome)}\n${revertDetail(outcome)}`;
+    return code === EXIT.OK ? { code, out: body, err: "" } : { code, out: "", err: body };
+}
+/**
+ * Not failures, but things that make a correct config look broken later — which is
+ * when a warning earns its noise.
+ */
+export function collectWarnings(ctx) {
+    const warnings = [];
+    if (ctx.processEnv.ANTHROPIC_API_KEY !== undefined && ctx.processEnv.ANTHROPIC_API_KEY !== "") {
+        warnings.push({
+            code: "anthropic-api-key-set",
+            // It shadows the claude.ai login and surfaces as a 401 from the gateway,
+            // which reads as "the CLI wrote a bad config" rather than "unset this".
+            message: "ANTHROPIC_API_KEY is set in your environment. It overrides the credential Claude Code manages and can cause 401s through the gateway — unset it if requests start failing.",
+        });
+    }
+    if (isInsecureGateway(ctx.urls.gateway)) {
+        warnings.push({
+            code: "insecure-gateway",
+            // Not just our one verifying request: this URL is what the written config
+            // points every future Claude Code request at, each carrying the AI21 key.
+            message: `${ctx.urls.gateway} is plain http, so the AI21 key will cross the network unencrypted on every request. Use an https gateway outside local development.`,
+        });
+    }
+    if (ctx.urls.gateway !== DEFAULT_URLS.gateway) {
+        warnings.push({
+            code: "non-production-gateway",
+            message: `Configured against a custom gateway (${ctx.urls.gateway}), not production.`,
+        });
+    }
+    return warnings;
+}
+/** Human-readable line for a config outcome. Never includes the key. */
+function humanLine(outcome) {
+    switch (outcome.kind) {
+        case "created":
+            return `Wrote ${outcome.path}`;
+        case "updated":
+            return `Updated ${outcome.path} (${outcome.changed.join(", ")})\nBacked up the previous file to ${outcome.backup}`;
+        case "unchanged":
+            return `Already configured — ${outcome.path} is up to date.`;
+        case "conflict":
+            return `${outcome.path} already sets values this command would change.`;
+        case "malformed":
+            return `Refusing to edit ${outcome.path}: ${outcome.reason}.`;
+        case "failed":
+            return `Could not write ${outcome.path}: ${outcome.reason}.`;
+    }
+}
+/** How each tier reads to a human, once it has succeeded. */
+const VERIFIED_VIA = {
+    "claude-cli": "`claude -p`",
+    "direct-ping": "a direct request",
+};
+/**
+ * Verification is never a failure: the config write is the deliverable, and a
+ * ping that could not be made — or that the gateway refused — does not un-write
+ * it. So a pass narrates and everything else warns.
+ */
+function verificationWarning(outcome) {
+    switch (outcome.kind) {
+        case "skipped":
+            return {
+                code: "verification-skipped",
+                message: `Skipped verification — no Anthropic credential was available. ${outcome.hint}`,
+            };
+        case "failed":
+            return {
+                code: "verification-failed",
+                message: `Could not verify through the gateway — ${outcome.reason}. The configuration was written and left in place.`,
+            };
+        default:
+            return undefined;
+    }
+}
+/** The stdout line for a successful verification; nothing for any other outcome. */
+function verificationLine(outcome) {
+    if (outcome?.kind !== "passed")
+        return "";
+    return `Verified through the gateway with ${VERIFIED_VIA[outcome.via]}.\n`;
+}
+/**
+ * One JSON object with what happened, where, why it exited that way, and any
+ * warnings. Flat and stable — a consumer should not have to parse prose.
+ */
+function jsonPayload(input, code, warnings) {
+    const { outcome } = input;
+    const payload = {
+        ok: code === EXIT.OK,
+        outcome: outcome.kind,
+        exitCode: code,
+        path: outcome.path,
+        gateway: input.urls.gateway,
+        warnings: warnings.map((w) => ({ code: w.code, message: w.message })),
+    };
+    // Structured rather than warning-only: a script should be able to tell "verified"
+    // from "written but unverified" without matching on prose.
+    if (input.verification !== undefined) {
+        const { kind, ...rest } = input.verification;
+        payload.verification = { status: kind, ...rest };
+    }
+    if (outcome.kind === "updated") {
+        payload.changed = outcome.changed;
+        payload.backup = outcome.backup;
+    }
+    if (outcome.kind === "conflict") {
+        payload.conflicts = outcome.conflicts.map((c) => ({ key: c.key }));
+    }
+    if (outcome.kind === "malformed" || outcome.kind === "failed") {
+        payload.reason = outcome.reason;
+    }
+    return `${JSON.stringify(payload, null, 2)}\n`;
+}
+export function report(input) {
+    const code = EXIT_FOR[input.outcome.kind];
+    const fromVerification = input.verification === undefined ? undefined : verificationWarning(input.verification);
+    const warnings = fromVerification === undefined ? input.warnings : [...input.warnings, fromVerification];
+    if (input.json) {
+        // Everything on stdout, nothing on stderr: a single parse of one stream.
+        return { code, out: jsonPayload(input, code, warnings), err: "" };
+    }
+    const warningText = warnings.map((w) => `warning: ${w.message}\n`).join("");
+    const body = `${humanLine(input.outcome)}\n${verificationLine(input.verification)}${input.detail ?? ""}`;
+    // Success narrates on stdout; a refusal belongs on stderr so `>/dev/null`
+    // still shows the user why nothing happened.
+    return code === EXIT.OK ? { code, out: body, err: warningText } : { code, out: "", err: `${body}${warningText}` };
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

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

package/dist/result.d.ts

@@ -0,0 +1,26 @@
+/** What every command hands back. Its own module so cli.ts and router.ts can share it. */
+/**
+ * Stable contract — `--json` consumers branch on these, so values are never
+ * reassigned once shipped. Later phases fill in the gaps.
+ */
+export declare const EXIT: {
+    readonly OK: 0;
+    /** Unexpected internal failure. 3+ are reserved for named outcomes. */
+    readonly INTERNAL: 1;
+    readonly USAGE: 2;
+    /** A managed key already holds a different value and `--yes` was not given. */
+    readonly CONFLICT: 3;
+    /** The existing settings.json could not be parsed, so it was left untouched. */
+    readonly MALFORMED: 4;
+    /** `uninstall` found none of the managed keys — there was nothing of ours to revert. */
+    readonly NOT_CONFIGURED: 5;
+    /** `uninstall --from-backup` was asked for, but no .bak exists. */
+    readonly NO_BACKUP: 6;
+    /** `login` did not complete: timed out, or the response was refused. */
+    readonly LOGIN_INCOMPLETE: 7;
+};
+export interface RunResult {
+    readonly code: number;
+    readonly out: string;
+    readonly err: string;
+}

package/dist/result.js

@@ -0,0 +1,22 @@
+/** What every command hands back. Its own module so cli.ts and router.ts can share it. */
+/**
+ * Stable contract — `--json` consumers branch on these, so values are never
+ * reassigned once shipped. Later phases fill in the gaps.
+ */
+export const EXIT = {
+    OK: 0,
+    /** Unexpected internal failure. 3+ are reserved for named outcomes. */
+    INTERNAL: 1,
+    USAGE: 2,
+    /** A managed key already holds a different value and `--yes` was not given. */
+    CONFLICT: 3,
+    /** The existing settings.json could not be parsed, so it was left untouched. */
+    MALFORMED: 4,
+    /** `uninstall` found none of the managed keys — there was nothing of ours to revert. */
+    NOT_CONFIGURED: 5,
+    /** `uninstall --from-backup` was asked for, but no .bak exists. */
+    NO_BACKUP: 6,
+    /** `login` did not complete: timed out, or the response was refused. */
+    LOGIN_INCOMPLETE: 7,
+};
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,EAAE,EAAE,CAAC;IACL,uEAAuE;IACvE,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,CAAC;IACR,+EAA+E;IAC/E,QAAQ,EAAE,CAAC;IACX,gFAAgF;IAChF,SAAS,EAAE,CAAC;IACZ,wFAAwF;IACxF,cAAc,EAAE,CAAC;IACjB,mEAAmE;IACnE,SAAS,EAAE,CAAC;IACZ,wEAAwE;IACxE,gBAAgB,EAAE,CAAC;CACX,CAAC"}

package/dist/revert.d.ts

@@ -0,0 +1,60 @@
+import { type ConfigPaths } from "./config.js";
+export type RevertOutcome = {
+    readonly kind: "reverted";
+    readonly path: string;
+    /** Keys we added, so reverting means deleting them. */
+    readonly removed: readonly string[];
+    /** Keys that held a value before we wrote, now put back. */
+    readonly restored: readonly string[];
+    /** A `.bak` was there but could not be parsed, so prior values were lost. */
+    readonly backupUnreadable: boolean;
+} | {
+    readonly kind: "restored";
+    readonly path: string;
+    readonly backup: string;
+}
+/** None of the managed keys were there — not ours to revert. */
+ | {
+    readonly kind: "not-configured";
+    readonly path: string;
+} | {
+    readonly kind: "agent-mismatch";
+    readonly path: string;
+    readonly expected: string;
+    readonly actual: string;
+}
+/** `--from-backup` would discard edits made since our write. */
+ | {
+    readonly kind: "drifted";
+    readonly path: string;
+    readonly backup: string;
+} | {
+    readonly kind: "no-backup";
+    readonly path: string;
+    readonly backup: string;
+} | {
+    readonly kind: "malformed";
+    readonly path: string;
+    readonly reason: string;
+} | {
+    readonly kind: "failed";
+    readonly path: string;
+    readonly reason: string;
+};
+export interface RevertOptions {
+    /** Restore the `.bak` verbatim instead of removing our keys surgically. */
+    readonly fromBackup: boolean;
+    /** Proceed with a restore that discards drift. */
+    readonly force: boolean;
+    /** When set, the stored `x-agent-id` must equal this or nothing is written. */
+    readonly agentIdGuard?: string | undefined;
+}
+type JsonObject = Record<string, unknown>;
+/**
+ * The `x-agent-id` currently stored in the `\n`-joined header value. Returns
+ * undefined when the header, or the whole value, is absent or unparseable — an
+ * absent id can never satisfy the guard, which is the safe direction.
+ */
+export declare function storedAgentId(env: JsonObject | undefined): string | undefined;
+export declare function revertConfig(paths: ConfigPaths, options: RevertOptions): RevertOutcome;
+export {};

package/dist/revert.js

@@ -0,0 +1,230 @@
+/**
+ * `uninstall` — undoing what this tool wrote, without a blind restore.
+ *
+ * Default: per-key revert. Each managed `env` key goes back to the value it held
+ * before we wrote, or is removed if it had none. `--from-backup` instead restores
+ * the `.bak` byte for byte, which discards later edits and so needs `--yes` once
+ * the file has drifted. `--agent-id` is a guard, not a selector.
+ *
+ * Same constraint as the writer: every path leaves the file byte-identical or
+ * replaces it atomically, and every refusal touches nothing.
+ */
+import { copyFileSync, existsSync, lstatSync, readFileSync, readlinkSync, realpathSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { MANAGED_KEYS, atomicWrite, describeFsError, isOurConfig, isPlainObject, serialize, } from "./config.js";
+/**
+ * Resolve a symlinked settings.json to what it names, so a revert writes through
+ * the link rather than replacing it — the same reason the writer does this.
+ */
+function followLink(path) {
+    try {
+        if (lstatSync(path, { throwIfNoEntry: false })?.isSymbolicLink() === true) {
+            return resolve(dirname(path), readlinkSync(path));
+        }
+    }
+    catch {
+        return path;
+    }
+    return path;
+}
+/** Reads and validates a settings file, mapping every failure to an outcome. */
+function load(path) {
+    let realPath;
+    let raw;
+    try {
+        realPath = realpathSync(path);
+        raw = readFileSync(realPath, "utf8");
+    }
+    catch (err) {
+        return { problem: { kind: "failed", path, reason: describeFsError(err) } };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        // No parser detail: the message is user-facing and the file may hold a key.
+        return { problem: { kind: "malformed", path, reason: "it is not valid JSON" } };
+    }
+    if (!isPlainObject(parsed)) {
+        return { problem: { kind: "malformed", path, reason: "its top level is not a JSON object" } };
+    }
+    const env = parsed.env;
+    if (env !== undefined && !isPlainObject(env)) {
+        return { problem: { kind: "malformed", path, reason: 'its "env" is not a JSON object' } };
+    }
+    return { file: { realPath, raw, parsed, env } };
+}
+/**
+ * The `x-agent-id` currently stored in the `\n`-joined header value. Returns
+ * undefined when the header, or the whole value, is absent or unparseable — an
+ * absent id can never satisfy the guard, which is the safe direction.
+ */
+export function storedAgentId(env) {
+    const headers = env?.ANTHROPIC_CUSTOM_HEADERS;
+    if (typeof headers !== "string")
+        return undefined;
+    for (const line of headers.split("\n")) {
+        const match = /^\s*x-agent-id\s*:\s*(.+?)\s*$/i.exec(line);
+        if (match?.[1] !== undefined)
+            return match[1];
+    }
+    return undefined;
+}
+/** Everything except the keys we manage — the part of the file that is not ours. */
+function withoutManagedKeys(parsed, env) {
+    if (env === undefined)
+        return parsed;
+    const remaining = Object.fromEntries(Object.entries(env).filter(([key]) => !isManaged(key)));
+    const keepEnv = Object.keys(remaining).length > 0;
+    // Rebuilt in the file's own key order rather than spread-and-append, so a revert
+    // reads as a minimal diff of someone else's file. An emptied env is dropped
+    // instead of being left behind as `{}` — that would be our litter, not theirs.
+    const result = {};
+    for (const [key, value] of Object.entries(parsed)) {
+        if (key !== "env") {
+            result[key] = value;
+            continue;
+        }
+        if (keepEnv)
+            result.env = remaining;
+    }
+    return result;
+}
+function isManaged(key) {
+    return MANAGED_KEYS.includes(key);
+}
+/** Whether anything outside our keys changed. Structural: indentation is not drift. */
+function hasDrifted(current, backupRaw) {
+    let backupParsed;
+    try {
+        backupParsed = JSON.parse(backupRaw);
+    }
+    catch {
+        // An unparseable backup cannot be compared, so treat it as drift and let
+        // --yes be the way through. Refusing by default is the safe direction.
+        return true;
+    }
+    if (!isPlainObject(backupParsed))
+        return true;
+    const backupEnv = isPlainObject(backupParsed.env) ? backupParsed.env : undefined;
+    return (JSON.stringify(withoutManagedKeys(current.parsed, current.env)) !==
+        JSON.stringify(withoutManagedKeys(backupParsed, backupEnv)));
+}
+function restoreFromBackup(paths, file, options) {
+    const { settings: path } = paths;
+    const backup = file.realPath === path ? paths.backup : `${file.realPath}.bak`;
+    if (!existsSync(backup)) {
+        return { kind: "no-backup", path, backup };
+    }
+    let backupRaw;
+    try {
+        backupRaw = readFileSync(backup, "utf8");
+    }
+    catch (err) {
+        return { kind: "failed", path, reason: describeFsError(err) };
+    }
+    if (!options.force && hasDrifted(file, backupRaw)) {
+        return { kind: "drifted", path, backup };
+    }
+    try {
+        // copyFileSync, not a parse-and-serialize round trip: "verbatim" has to mean
+        // byte for byte, including formatting and any key order the developer chose.
+        copyFileSync(backup, file.realPath);
+    }
+    catch (err) {
+        return { kind: "failed", path, reason: describeFsError(err) };
+    }
+    return { kind: "restored", path, backup };
+}
+/** Rebuilds the document with a new `env`, preserving the file's own key order. */
+function withEnv(parsed, env) {
+    const keep = env !== undefined && Object.keys(env).length > 0;
+    const result = {};
+    for (const [key, value] of Object.entries(parsed)) {
+        if (key !== "env") {
+            result[key] = value;
+            continue;
+        }
+        if (keep)
+            result.env = env;
+    }
+    return result;
+}
+/** The `env` block as it was before we wrote, or undefined if that is unknowable. */
+function previousEnv(paths, file) {
+    const backup = file.realPath === paths.settings ? paths.backup : `${file.realPath}.bak`;
+    if (!existsSync(backup)) {
+        // No backup means we created the file, so every managed key is one we added.
+        return { unreadable: false };
+    }
+    try {
+        const parsed = JSON.parse(readFileSync(backup, "utf8"));
+        if (!isPlainObject(parsed))
+            return { unreadable: true };
+        return { env: isPlainObject(parsed.env) ? parsed.env : {}, unreadable: false };
+    }
+    catch {
+        return { unreadable: true };
+    }
+}
+/**
+ * Restore each managed key to its prior value rather than deleting it: deletion
+ * would silently discard a developer's own `ANTHROPIC_BASE_URL` that we overwrote
+ * with `--yes`. A key with no prior value is one we added, so it is removed. Every
+ * other key is copied across untouched.
+ */
+function revertManagedKeys(paths, file) {
+    const { settings: path } = paths;
+    const { env: before, unreadable } = previousEnv(paths, file);
+    const removed = [];
+    const restored = [];
+    const nextEnv = {};
+    for (const [key, value] of Object.entries(file.env ?? {})) {
+        if (!isManaged(key)) {
+            nextEnv[key] = value;
+            continue;
+        }
+        const previous = before?.[key];
+        if (previous === undefined) {
+            removed.push(key);
+            continue;
+        }
+        nextEnv[key] = previous;
+        restored.push(key);
+    }
+    try {
+        // No backup taken, deliberately: overwriting the .bak with the configured state
+        // would destroy the very snapshot this function reads prior values from.
+        atomicWrite(file.realPath, serialize(withEnv(file.parsed, nextEnv)));
+    }
+    catch (err) {
+        return { kind: "failed", path, reason: describeFsError(err) };
+    }
+    return { kind: "reverted", path, removed, restored, backupUnreadable: unreadable };
+}
+export function revertConfig(paths, options) {
+    const { settings: path } = paths;
+    // Nothing there at all reads the same as nothing of ours in it.
+    if (!existsSync(followLink(path))) {
+        return { kind: "not-configured", path };
+    }
+    const loaded = load(path);
+    if ("problem" in loaded)
+        return loaded.problem;
+    const { file } = loaded;
+    // Gates both behaviours: without the marker this is not a file we configured.
+    if (!isOurConfig(file.env)) {
+        return { kind: "not-configured", path };
+    }
+    // The guard applies to both behaviours — a mismatched agent must stop a
+    // verbatim restore just as firmly as a surgical revert.
+    if (options.agentIdGuard !== undefined) {
+        const stored = storedAgentId(file.env);
+        if (stored !== options.agentIdGuard) {
+            return { kind: "agent-mismatch", path, expected: options.agentIdGuard, actual: stored ?? "none" };
+        }
+    }
+    return options.fromBackup ? restoreFromBackup(paths, file, options) : revertManagedKeys(paths, file);
+}
+//# sourceMappingURL=revert.js.map

package/dist/revert.js.map

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

package/dist/router.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Verb dispatch. Handlers return streams and an exit code rather than writing or
+ * exiting, so a command can be asserted end to end without spawning a process.
+ */
+import { type ParsedArgs } from "./args.js";
+import { type PathContext } from "./config.js";
+import { type PromptIo } from "./prompt.js";
+import { type LoginDeps } from "./login/session.js";
+import { type RunResult } from "./result.js";
+import { type VerifyDeps } from "./verify.js";
+/** Everything the dispatcher needs from the outside world, injected at the edge. */
+export interface RunContext {
+    readonly paths: PathContext;
+    readonly prompt: PromptIo;
+    readonly processEnv: Record<string, string | undefined>;
+    readonly verify: VerifyDeps;
+    readonly login: LoginDeps;
+    /** Progress output while `login` waits. Streams, so it cannot go in RunResult. */
+    readonly notify: (message: string) => void;
+}
+export declare function dispatch(args: ParsedArgs, ctx: RunContext): Promise<RunResult>;