@dharta/cli 0.6.77

package/dist/completions.js

@@ -0,0 +1,120 @@
+// `dharta completion <bash|zsh>` (RFC 0013 CLI-12): shell completion
+// scripts generated statically by walking the commander program - no
+// runtime dependency, no shelling out. The output is a snapshot of this
+// CLI version's command surface; regenerate after updating.
+export function specFromCommand(cmd) {
+    return {
+        name: cmd.name(),
+        aliases: commandAliases(cmd),
+        description: sanitize(cmd.description()),
+        options: [
+            ...cmd.options.filter((o) => !o.hidden && o.long).map((o) => o.long),
+            "--help",
+        ],
+        argChoices: cmd.registeredArguments.flatMap((a) => a.argChoices ?? []),
+        subs: cmd.commands
+            .filter((c) => !c._hidden)
+            .map((c) => specFromCommand(c)),
+    };
+}
+// First sentence, single line. Shell-specific escaping happens when rendering
+// so meaningful tokens like audit_log:export keep their punctuation.
+function sanitize(description) {
+    const firstSentence = description.replace(/\s+/g, " ").trim().split(". ")[0];
+    return firstSentence.replace(/\.$/, "");
+}
+function words(spec) {
+    return [...subcommandWords(spec), ...spec.argChoices, ...spec.options].join(" ");
+}
+function subcommandWords(spec) {
+    return spec.subs.flatMap((sub) => commandNames(sub));
+}
+function commandNames(spec) {
+    return [spec.name, ...spec.aliases];
+}
+function commandAliases(cmd) {
+    const maybeAliases = cmd.aliases;
+    return typeof maybeAliases === "function" ? maybeAliases.call(cmd) : [];
+}
+function completionEntries(root) {
+    const entries = [];
+    const visit = (spec, paths) => {
+        for (const path of paths) {
+            entries.push({
+                path,
+                words: words(spec),
+                describedCommands: describedSubcommands(spec),
+            });
+        }
+        for (const child of spec.subs) {
+            const childPaths = expandPaths(paths, commandNames(child));
+            visit(child, childPaths);
+        }
+    };
+    visit(root, [""]);
+    return entries;
+}
+function expandPaths(prefixes, names) {
+    return prefixes.flatMap((prefix) => names.map((name) => (prefix ? `${prefix} ${name}` : name)));
+}
+function describedSubcommands(spec) {
+    return spec.subs.flatMap((sub) => [
+        `'${escapeZshDescription(sub.name)}:${escapeZshDescription(sub.description)}'`,
+        ...sub.aliases.map((alias) => `'${escapeZshDescription(alias)}:Alias of ${escapeZshDescription(sub.name)}'`),
+    ]).join(" ");
+}
+function escapeBashCase(value) {
+    return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\$/g, "\\$").replace(/`/g, "\\`");
+}
+function escapeZshCase(value) {
+    return value.replace(/\\/g, "\\\\").replace(/ /g, "\\ ").replace(/\)/g, "\\)");
+}
+function zshCasePattern(value) {
+    return value === "" ? '""' : escapeZshCase(value);
+}
+function escapeZshDescription(value) {
+    return value.replace(/\\/g, "\\\\").replace(/'/g, "'\\''").replace(/:/g, "\\:");
+}
+export function bashCompletion(program) {
+    const spec = specFromCommand(program);
+    const entries = completionEntries(spec);
+    const lines = [
+        "# bash completion for karta - generated by `dharta completion bash`",
+        "# Load with: source <(dharta completion bash)  (or append to ~/.bash_completion)",
+        "_karta() {",
+        '  local cur="${COMP_WORDS[COMP_CWORD]}"',
+        '  local path="${COMP_WORDS[@]:1:$((COMP_CWORD - 1))}"',
+        '  local words=""',
+        '  case "$path" in',
+    ];
+    for (const entry of entries) {
+        lines.push(`    "${escapeBashCase(entry.path)}") words="${escapeBashCase(entry.words)}" ;;`);
+    }
+    lines.push("  esac", '  COMPREPLY=( $(compgen -W "$words" -- "$cur") )', "}", "complete -F _karta karta");
+    return lines.join("\n");
+}
+export function zshCompletion(program) {
+    const spec = specFromCommand(program);
+    const entries = completionEntries(spec);
+    const lines = [
+        "#compdef karta",
+        "# zsh completion for karta - generated by `dharta completion zsh`",
+        "# Install: dharta completion zsh > ~/.zfunc/_dharta  (with fpath+=(~/.zfunc) before compinit)",
+        "",
+        "_karta() {",
+        "  local -a reply",
+        '  local path=""',
+        "  if (( CURRENT > 2 )); then",
+        '    path="${(j: :)words[2,$((CURRENT - 1))]}"',
+        "  fi",
+        '  case "$path" in',
+    ];
+    for (const entry of entries) {
+        lines.push(`    ${zshCasePattern(entry.path)})`, entry.describedCommands
+            ? `      reply=( ${entry.describedCommands} ); _describe -t commands 'dharta command' reply`
+            : "      true", entry.words ? `      compadd -- ${entry.words}` : "      true", "      return", "      ;;");
+    }
+    lines.push("  esac", "}", "", '_karta "$@"');
+    return lines.join("\n");
+}
+//# sourceMappingURL=completions.js.map

package/dist/completions.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,20 @@
+export interface Profile {
+    api_key: string;
+    base_url: string;
+    git_base_url?: string;
+    workspace_git_base_url?: string;
+}
+export interface Config {
+    default_profile: string;
+    profiles: Record<string, Profile>;
+}
+export declare function setHomeForTesting(home: string | undefined): void;
+export declare function configPath(): string;
+declare const DEFAULT_BASE_URL = "https://dharta.ai";
+declare const DEFAULT_GIT_BASE_URL = "https://git.dharta.ai";
+export declare function loadConfig(): Promise<Config | null>;
+export declare function saveProfile(name: string, profile: Profile): Promise<string>;
+export declare function removeProfile(name: string): Promise<boolean>;
+export declare function activeProfile(): Promise<Profile>;
+export declare function resolveBaseUrl(): Promise<string>;
+export { DEFAULT_BASE_URL, DEFAULT_GIT_BASE_URL };

package/dist/config.js

@@ -0,0 +1,98 @@
+import { promises as fs } from "node:fs";
+import { homedir } from "node:os";
+import * as path from "node:path";
+import TOML from "@iarna/toml";
+// Allow tests to redirect HOME without setting process.env.HOME globally.
+let homeOverride;
+export function setHomeForTesting(home) {
+    homeOverride = home;
+}
+export function configPath() {
+    const home = homeOverride ?? process.env.HOME ?? homedir();
+    return path.join(home, ".dharta", "config.toml");
+}
+// NOT api.dharta.ai: that name resolves to the data plane (the RFC 0011
+// as-built base-URL confusion this constant fixes). The control API
+// lives on the Rails app.
+const DEFAULT_BASE_URL = "https://dharta.ai";
+const DEFAULT_GIT_BASE_URL = "https://git.dharta.ai";
+export async function loadConfig() {
+    try {
+        const raw = await fs.readFile(configPath(), "utf8");
+        const parsed = TOML.parse(raw);
+        if (!parsed.default_profile || !parsed.profiles)
+            return null;
+        return {
+            default_profile: parsed.default_profile,
+            profiles: parsed.profiles,
+        };
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+export async function saveProfile(name, profile) {
+    const target = configPath();
+    await fs.mkdir(path.dirname(target), { recursive: true, mode: 0o700 });
+    const existing = (await loadConfig()) ?? {
+        default_profile: name,
+        profiles: {},
+    };
+    existing.profiles[name] = profile;
+    existing.default_profile = name;
+    await fs.writeFile(target, TOML.stringify(existing), {
+        mode: 0o600,
+    });
+    return target;
+}
+// Remove a stored profile (auth logout). Returns false if it didn't
+// exist. If the default profile was removed, the first remaining one
+// becomes the default; the file is deleted when no profiles remain.
+export async function removeProfile(name) {
+    const cfg = await loadConfig();
+    if (!cfg || !cfg.profiles[name])
+        return false;
+    delete cfg.profiles[name];
+    const remaining = Object.keys(cfg.profiles);
+    if (remaining.length === 0) {
+        await fs.rm(configPath(), { force: true });
+        return true;
+    }
+    if (cfg.default_profile === name)
+        cfg.default_profile = remaining[0];
+    await fs.writeFile(configPath(), TOML.stringify(cfg), { mode: 0o600 });
+    return true;
+}
+export async function activeProfile() {
+    const cfg = await loadConfig();
+    if (!cfg) {
+        throw new Error("Not logged in. Run `dharta login` to store an API key in ~/.dharta/config.toml.");
+    }
+    const profile = cfg.profiles[cfg.default_profile];
+    if (!profile) {
+        throw new Error(`Default profile '${cfg.default_profile}' not found in ${configPath()}. ` +
+            "Run `dharta login` to recreate it.");
+    }
+    return {
+        api_key: profile.api_key,
+        base_url: profile.base_url || DEFAULT_BASE_URL,
+        git_base_url: profile.git_base_url || DEFAULT_GIT_BASE_URL,
+        workspace_git_base_url: profile.workspace_git_base_url,
+    };
+}
+// Base URL for commands that work without a credential (init's template
+// fetch): env override, then the stored profile, then the default.
+export async function resolveBaseUrl() {
+    if (process.env.DHARTA_BASE_URL)
+        return process.env.DHARTA_BASE_URL;
+    try {
+        return (await activeProfile()).base_url;
+    }
+    catch {
+        return DEFAULT_BASE_URL;
+    }
+}
+export { DEFAULT_BASE_URL, DEFAULT_GIT_BASE_URL };
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,IAAI,MAAM,aAAa,CAAC;AA6B/B,0EAA0E;AAC1E,IAAI,YAAgC,CAAC;AAErC,MAAM,UAAU,iBAAiB,CAAC,IAAwB;IACxD,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACnD,CAAC;AAED,wEAAwE;AACxE,oEAAoE;AACpE,0BAA0B;AAC1B,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAC7C,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA+B,CAAC;QAC7D,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,MAAM,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC7D,OAAO;YACL,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,OAAgB;IAEhB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,CAAC,MAAM,UAAU,EAAE,CAAC,IAAI;QACvC,eAAe,EAAE,IAAI;QACrB,QAAQ,EAAE,EAAE;KACb,CAAC;IACF,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,eAAe,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,CAAC,SAAS,CAChB,MAAM,EACN,IAAI,CAAC,SAAS,CAAC,QAAmC,CAAC,EACnD;QACE,IAAI,EAAE,KAAK;KACZ,CACF,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,oEAAoE;AACpE,qEAAqE;AACrE,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE1B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,EAAE,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,GAAG,CAAC,eAAe,KAAK,IAAI;QAAE,GAAG,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,EAAE,CAAC,SAAS,CAChB,UAAU,EAAE,EACZ,IAAI,CAAC,SAAS,CAAC,GAA8B,CAAC,EAC9C,EAAE,IAAI,EAAE,KAAK,EAAE,CAChB,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;IAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,oBAAoB,GAAG,CAAC,eAAe,kBAAkB,UAAU,EAAE,IAAI;YACvE,oCAAoC,CACvC,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,gBAAgB;QAC9C,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,oBAAoB;QAC1D,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;KACvD,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACpE,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,gBAAgB,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,14 @@
+import { Dharta, HttpClient } from "@dharta/sdk";
+export interface CliContext {
+    sdk: Dharta;
+    http: HttpClient;
+    baseUrl: string;
+    apiKey: string;
+    fetch?: typeof fetch;
+}
+export interface CtxOverrides {
+    apiKey?: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+}
+export declare function buildContext(over?: CtxOverrides): Promise<CliContext>;

package/dist/context.js

@@ -0,0 +1,38 @@
+import { Dharta, HttpClient } from "@dharta/sdk";
+import { activeProfile, DEFAULT_BASE_URL } from "./config.js";
+import { cliFormatError, cliFormatNetworkError } from "./api-error.js";
+export async function buildContext(over = {}) {
+    let apiKey = over.apiKey;
+    let baseUrl = over.baseUrl;
+    // Env overrides config everywhere (the GH_TOKEN pattern, RFC 0013
+    // §2); explicit per-call overrides beat both. DHARTA_BASE_URL applies
+    // regardless of where the key came from, matching resolveBaseUrl.
+    baseUrl = baseUrl ?? process.env.DHARTA_BASE_URL;
+    if (!apiKey && process.env.DHARTA_API_KEY) {
+        apiKey = process.env.DHARTA_API_KEY;
+    }
+    if (!apiKey) {
+        const p = await activeProfile();
+        apiKey = p.api_key;
+        baseUrl = baseUrl ?? p.base_url;
+    }
+    if (!baseUrl)
+        baseUrl = DEFAULT_BASE_URL;
+    const fetchImpl = over.fetch;
+    const sdk = new Dharta({
+        apiKey,
+        baseUrl,
+        fetch: fetchImpl,
+        formatError: cliFormatError,
+        formatNetworkError: cliFormatNetworkError,
+    });
+    const http = new HttpClient({
+        apiKey,
+        baseUrl,
+        fetch: fetchImpl,
+        formatError: cliFormatError,
+        formatNetworkError: cliFormatNetworkError,
+    });
+    return { sdk, http, baseUrl, apiKey, fetch: fetchImpl };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAsBvE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAqB,EAAE;IAEvB,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACzB,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC3B,kEAAkE;IAClE,sEAAsE;IACtE,kEAAkE;IAClE,OAAO,GAAG,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACjD,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC1C,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACtC,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;QAChC,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC;QACnB,OAAO,GAAG,OAAO,IAAI,CAAC,CAAC,QAAQ,CAAC;IAClC,CAAC;IACD,IAAI,CAAC,OAAO;QAAE,OAAO,GAAG,gBAAgB,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;IAC7B,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC;QACrB,MAAM;QACN,OAAO;QACP,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,cAAc;QAC3B,kBAAkB,EAAE,qBAAqB;KAC1C,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC;QAC1B,MAAM;QACN,OAAO;QACP,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,cAAc;QAC3B,kBAAkB,EAAE,qBAAqB;KAC1C,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC1D,CAAC"}

package/dist/device-flow.d.ts

@@ -0,0 +1,9 @@
+export interface DeviceFlowOptions {
+    baseUrl: string;
+    clientName?: string;
+    fetchImpl?: typeof fetch;
+    log?: (line: string) => void;
+    openBrowser?: (url: string) => Promise<boolean>;
+    sleep?: (ms: number) => Promise<void>;
+}
+export declare function deviceFlowLogin(opts: DeviceFlowOptions): Promise<string>;

package/dist/device-flow.js

@@ -0,0 +1,127 @@
+// RFC 8628 device-flow client for `dharta login` (RFC 0013 CLI-1).
+// Mints a code pair on the control plane, shows the user code, opens the
+// approve page, and polls the token endpoint until the browser approval
+// mints a named CLI credential.
+import { openBrowser } from "./browser.js";
+const EXPIRED_MESSAGE = "The login code expired before it was approved. Run `dharta login` again.";
+// Consecutive network failures tolerated before giving up — the
+// approval window is minutes long, so one wifi blip must not abort it.
+const MAX_CONSECUTIVE_NETWORK_FAILURES = 5;
+// Resolves to the freshly minted API key (dh_live_…).
+export async function deviceFlowLogin(opts) {
+    const fetchImpl = (opts.fetchImpl ?? globalThis.fetch).bind(globalThis);
+    const log = opts.log ?? ((line) => console.log(line));
+    const sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    const base = opts.baseUrl.replace(/\/+$/, "");
+    let mintRes;
+    try {
+        mintRes = await fetchImpl(`${base}/cli/device_authorizations`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", Accept: "application/json" },
+            body: JSON.stringify({ client_name: opts.clientName }),
+        });
+    }
+    catch (error) {
+        throw new Error(`Could not start the login: could not reach ${base} (${formatCause(error)}). ` +
+            "Check your network and try `dharta login` again.");
+    }
+    if (!mintRes.ok) {
+        throw new Error(`Could not start the login (${mintRes.status} from ${base}). ` +
+            "Check your network and try `dharta login` again.");
+    }
+    let mint;
+    try {
+        mint = (await mintRes.json());
+    }
+    catch (error) {
+        throw new Error(`Could not start the login: ${base} returned invalid JSON (${formatCause(error)}). ` +
+            "Check DHARTA_BASE_URL or try `dharta login` again.");
+    }
+    if (typeof mint.device_code !== "string" ||
+        typeof mint.user_code !== "string" ||
+        typeof mint.verification_uri !== "string" ||
+        typeof mint.expires_in !== "number") {
+        throw new Error(`Could not start the login: ${base} returned an incomplete device login response. ` +
+            "Check DHARTA_BASE_URL or try `dharta login` again.");
+    }
+    const approveUrl = mint.verification_uri_complete ?? mint.verification_uri;
+    log(`! First, verify this code in your browser: ${mint.user_code}`);
+    const opened = await (opts.openBrowser ?? openBrowser)(approveUrl);
+    log(opened
+        ? `Opening ${approveUrl} in your browser…`
+        : `Open this URL to approve: ${approveUrl}`);
+    log("Waiting for approval…");
+    // RFC 8628: interval is optional, default 5s. Guard against a
+    // missing/garbage value — setTimeout(NaN) fires immediately and
+    // would hot-loop the poll.
+    let intervalMs = Math.max(Number(mint.interval) || 5, 1) * 1000;
+    const deadline = Date.now() + mint.expires_in * 1000;
+    let networkFailures = 0;
+    while (Date.now() < deadline) {
+        await sleep(intervalMs);
+        let res;
+        try {
+            res = await fetchImpl(`${base}/cli/device_authorizations/token`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json", Accept: "application/json" },
+                body: JSON.stringify({ device_code: mint.device_code }),
+            });
+        }
+        catch {
+            // Transient network failure mid-poll: keep waiting, the
+            // deadline bounds the loop.
+            networkFailures += 1;
+            if (networkFailures >= MAX_CONSECUTIVE_NETWORK_FAILURES) {
+                throw new Error(`Lost the connection to ${base} while waiting for approval. ` +
+                    "Check your network and run `dharta login` again.");
+            }
+            continue;
+        }
+        networkFailures = 0;
+        if (res.ok) {
+            let token;
+            try {
+                token = (await res.json()).access_token;
+            }
+            catch {
+                // fall through to the throw below
+            }
+            if (!token) {
+                throw new Error("The server approved the login but returned no token. Run `dharta login` again.");
+            }
+            return token;
+        }
+        if (res.status === 429) {
+            // Rate-limited (Rack::Attack): back off like slow_down rather
+            // than keeping the cadence that tripped the limit.
+            await res.text().catch(() => { });
+            intervalMs += 5000;
+            continue;
+        }
+        let error = "";
+        try {
+            error = (await res.json()).error ?? "";
+        }
+        catch {
+            // non-JSON error body: fall through to the unknown-error throw
+        }
+        switch (error) {
+            case "authorization_pending":
+                continue;
+            case "slow_down":
+                intervalMs += 5000; // RFC 8628 §3.5: back off by 5s on slow_down
+                continue;
+            case "expired_token":
+                throw new Error(EXPIRED_MESSAGE);
+            case "access_denied":
+                throw new Error("The login request was denied in the browser.");
+            default:
+                throw new Error(`Login failed (${error || `HTTP ${res.status}`}). Run \`dharta login\` again.`);
+        }
+    }
+    throw new Error(EXPIRED_MESSAGE);
+}
+function formatCause(error) {
+    return error instanceof Error && error.message ? error.message : String(error);
+}
+//# sourceMappingURL=device-flow.js.map

package/dist/device-flow.js.map

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

package/dist/harness-preflight.d.ts

@@ -0,0 +1,24 @@
+export interface CatalogVersion {
+    version: string;
+    status: string;
+}
+export interface CatalogHarness {
+    id: string;
+    name: string;
+    default_version?: string | null;
+    versions: CatalogVersion[];
+}
+export interface PreflightDeps {
+    dir: string;
+    baseUrl: string;
+    log: (line: string) => void;
+    fetchImpl?: typeof fetch;
+    detectLocalVersion?: (type: string) => Promise<string | null>;
+    confirm?: (question: string) => Promise<boolean>;
+}
+export declare function sniffType(dir: string): string;
+export declare function compareVersions(a: string, b: string): number;
+export declare function versionHasPrefix(version: string, prefix: string): boolean;
+export declare function resolvePreview(constraint: string | undefined, supported: string[], defaultVersion?: string | null): string | null;
+export declare function closestForParity(local: string | null, supported: string[]): string | null;
+export declare function harnessPreflight(deps: PreflightDeps): Promise<void>;