@rotifer/playground 0.27.0 → 0.29.0

package/dist/commands/genome.d.ts

@@ -0,0 +1,82 @@
+import { Command } from "commander";
+import type { AgentRecord } from "./agent-create.js";
+import { type AlgebraExpr, type CredentialFinding, type CredentialLayer, type GeneReference, type GenomeBlueprint } from "./genome-format.js";
+export * from "./genome-format.js";
+export interface RoleSummary {
+    role: string;
+    geneId: string;
+    fidelity: string;
+    hasHints: boolean;
+}
+export declare class GenomeExportError extends Error {
+    readonly hint?: string | undefined;
+    readonly findings?: CredentialFinding[] | undefined;
+    constructor(message: string, hint?: string | undefined, findings?: CredentialFinding[] | undefined);
+}
+/** Find a local agent by id, or by name when the name is unique. */
+export declare function findAgent(root: string, ref: string): AgentRecord;
+/** Composition type exactly as `agent run` derives it. */
+export declare function compositionTypeOf(agent: AgentRecord): string;
+/**
+ * Map the agent's composition onto §15.2, limited to what `agent run` executes:
+ * branches are single genes, Par/Cond/Try take the genome in order. Anything
+ * else fails rather than being approximated.
+ */
+export declare function buildComposition(agent: AgentRecord, refs: GeneReference[]): {
+    composition: AlgebraExpr;
+    parMerge?: string;
+};
+export interface BuildBlueprintInput {
+    root: string;
+    genesDir: string;
+    agent: AgentRecord;
+    lock?: boolean;
+    minFitness?: number;
+    minVg?: number;
+    description?: string;
+    author?: string;
+    now?: Date;
+}
+export interface BuildBlueprintResult {
+    blueprint: GenomeBlueprint;
+    roles: RoleSummary[];
+    notices: string[];
+}
+export declare function buildBlueprint(input: BuildBlueprintInput): BuildBlueprintResult;
+export interface ExportGenomeInput extends BuildBlueprintInput {
+    output: string;
+}
+export interface ExportGenomeResult {
+    file: string;
+    agent: string;
+    composition: string;
+    geneCount: number;
+    mode: "capability" | "lock";
+    roles: RoleSummary[];
+    notices: string[];
+    credentialScan: {
+        passed: true;
+        layers: CredentialLayer[];
+    };
+}
+/**
+ * Build, scan, and write a Blueprint. Nothing is written when the scan finds
+ * anything, or when this CLI's own import would refuse the file: the reader's
+ * rules (Cond forms, numbers, strings, required fields) run on the exact text.
+ */
+export declare function exportGenome(input: ExportGenomeInput): ExportGenomeResult;
+export interface GenomeExportOptions {
+    output?: string;
+    lock?: boolean;
+    minFitness?: string;
+    minVg?: string;
+    description?: string;
+}
+/** Run `genome export`; returns the process exit code. */
+export declare function runGenomeExport(agentRef: string, options: GenomeExportOptions, ctx: {
+    root: string;
+    genesDir: string;
+    author?: string;
+}): number;
+export declare const genomeCommand: Command;
+//# sourceMappingURL=genome.d.ts.map

package/dist/commands/genome.d.ts.map

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

package/dist/commands/genome.js

@@ -0,0 +1,392 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genomeCommand = exports.GenomeExportError = void 0;
+exports.findAgent = findAgent;
+exports.compositionTypeOf = compositionTypeOf;
+exports.buildComposition = buildComposition;
+exports.buildBlueprint = buildBlueprint;
+exports.exportGenome = exportGenome;
+exports.runGenomeExport = runGenomeExport;
+const commander_1 = require("commander");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const display = __importStar(require("../utils/display.js"));
+const config_js_1 = require("../utils/config.js");
+const project_root_js_1 = require("../utils/project-root.js");
+const binding_js_1 = require("../utils/binding.js");
+const validate_gene_name_js_1 = require("../utils/validate-gene-name.js");
+const auth_js_1 = require("../cloud/auth.js");
+const genome_format_js_1 = require("./genome-format.js");
+__exportStar(require("./genome-format.js"), exports);
+class GenomeExportError extends Error {
+    hint;
+    findings;
+    constructor(message, hint, findings) {
+        super(message);
+        this.hint = hint;
+        this.findings = findings;
+        this.name = "GenomeExportError";
+    }
+}
+exports.GenomeExportError = GenomeExportError;
+// ── Agent lookup ─────────────────────────────────────────────
+/** Find a local agent by id, or by name when the name is unique. */
+function findAgent(root, ref) {
+    const agentsDir = (0, node_path_1.join)(root, ".rotifer", "agents");
+    const records = (0, node_fs_1.existsSync)(agentsDir)
+        ? (0, node_fs_1.readdirSync)(agentsDir)
+            .filter((f) => f.endsWith(".json"))
+            .map((f) => JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(agentsDir, f), "utf-8")))
+        : [];
+    const byId = records.find((a) => a.id === ref);
+    if (byId)
+        return byId;
+    const byName = records.filter((a) => a.name === ref);
+    if (byName.length === 1)
+        return byName[0];
+    if (byName.length > 1) {
+        throw new GenomeExportError(`${byName.length} agents are named '${ref}'`, `Pass one of their ids instead: ${byName.map((a) => a.id).join(", ")}`);
+    }
+    throw new GenomeExportError(`Agent '${ref}' not found`, "List local agents: rotifer agent list");
+}
+/** Composition type exactly as `agent run` derives it. */
+function compositionTypeOf(agent) {
+    const comp = agent.composition;
+    const declared = typeof comp === "object" && comp !== null ? comp.type : comp;
+    return (typeof declared === "string" && declared) || (agent.genome.length >= 2 ? "Seq" : "Single");
+}
+function outsideSubset(type, why) {
+    return new GenomeExportError(`Composition '${type}' cannot be exported: ${why}`, "v0.9.2 exports only what 'rotifer agent run' executes faithfully: " +
+        "Single (1 gene), Seq, Par (2+ genes), Cond and Try (exactly 2 genes).");
+}
+/**
+ * Map the agent's composition onto §15.2, limited to what `agent run` executes:
+ * branches are single genes, Par/Cond/Try take the genome in order. Anything
+ * else fails rather than being approximated.
+ */
+function buildComposition(agent, refs) {
+    const type = compositionTypeOf(agent);
+    const comp = (typeof agent.composition === "object" ? agent.composition : {});
+    const leaf = (i) => ({ Gene: { geneRef: refs[i] } });
+    const n = refs.length;
+    switch (type) {
+        case "Single":
+            if (n !== 1)
+                throw outsideSubset(type, `needs exactly 1 gene, the genome has ${n}`);
+            return { composition: leaf(0) };
+        case "Seq":
+            if (n < 1)
+                throw outsideSubset(type, "the genome is empty");
+            return { composition: { Seq: { steps: refs.map((_, i) => leaf(i)) } } };
+        case "Par": {
+            if (n < 2)
+                throw outsideSubset(type, `needs at least 2 genes, the genome has ${n}`);
+            // Right-associative: [a, b, c] → Par(a, Par(b, c)). No deadline — `agent run` has none.
+            let expr = leaf(n - 1);
+            for (let i = n - 2; i >= 0; i--)
+                expr = { Par: { left: leaf(i), right: expr } };
+            return { composition: expr, parMerge: comp.merge || "first" };
+        }
+        case "Cond": {
+            if (n !== 2)
+                throw outsideSubset(type, `needs exactly 2 genes, the genome has ${n}`);
+            // Same defaults `agent run` applies to a missing predicate.
+            const pred = comp.predicate ?? {};
+            const op = pred.op || "Eq";
+            const operator = Object.hasOwn(genome_format_js_1.COMPARE_OPS, op) ? genome_format_js_1.COMPARE_OPS[op] : undefined;
+            if (!operator) {
+                throw outsideSubset(type, `unknown predicate operator '${op}' (expected one of ${Object.keys(genome_format_js_1.COMPARE_OPS).join(", ")})`);
+            }
+            return {
+                composition: {
+                    Cond: {
+                        predicate: { field: pred.field || "type", operator, value: pred.value ?? pred.equals ?? "primary" },
+                        ifTrue: leaf(0),
+                        ifFalse: leaf(1),
+                    },
+                },
+            };
+        }
+        case "Try":
+            if (n !== 2)
+                throw outsideSubset(type, `needs exactly 2 genes, the genome has ${n}`);
+            return { composition: { TryCatch: { body: leaf(0), handler: leaf(1) } } };
+        default:
+            throw outsideSubset(type, "§15.2 has no such operator, or it is outside the v0.9.2 executable subset");
+    }
+}
+function readJson(path) {
+    if (!(0, node_fs_1.existsSync)(path))
+        return null;
+    try {
+        return JSON.parse((0, node_fs_1.readFileSync)(path, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function hintForUncomputableId(gene, reason) {
+    if (/ir\.wasm|rotifer\.version|rotifer\.constraints/.test(reason)) {
+        return `Compile it first: rotifer compile ${gene}`;
+    }
+    if (/fidelity/.test(reason))
+        return `Re-wrap it so phenotype.json declares a fidelity: rotifer wrap ${gene}`;
+    return "See docs/gene-id-v2.md §5 for what makes a gene ID computable.";
+}
+function checkUnitInterval(name, value) {
+    if (value === undefined)
+        return;
+    if (!Number.isFinite(value) || value < 0 || value > 1) {
+        throw new GenomeExportError(`${name} must be a number between 0 and 1`);
+    }
+}
+function buildBlueprint(input) {
+    const { root, genesDir, agent } = input;
+    const genesRoot = (0, node_path_1.join)(root, genesDir);
+    const notices = [];
+    checkUnitInterval("--min-fitness", input.minFitness);
+    if (input.minVg !== undefined) {
+        if (!Number.isFinite(input.minVg) || input.minVg < genome_format_js_1.MIN_VG_FLOOR || input.minVg >= 1) {
+            throw new GenomeExportError(`--min-vg must be in [${genome_format_js_1.MIN_VG_FLOOR}, 1.0)`, "§5.1 does not allow a V(g) threshold below 0.5.");
+        }
+    }
+    if (!Array.isArray(agent.genome) || agent.genome.length === 0) {
+        throw new GenomeExportError(`Agent '${agent.name}' has an empty genome`);
+    }
+    const seen = new Set();
+    for (const gene of agent.genome) {
+        if (seen.has(gene)) {
+            throw new GenomeExportError(`Gene '${gene}' appears more than once in the genome`, "A Blueprint keys each role by gene name, so every gene can appear only once.");
+        }
+        seen.add(gene);
+    }
+    const refs = [];
+    const roles = [];
+    const capabilities = {};
+    const hints = {};
+    for (const gene of agent.genome) {
+        try {
+            (0, validate_gene_name_js_1.validateGeneName)(gene);
+        }
+        catch (err) {
+            throw new GenomeExportError(err.message);
+        }
+        const geneDir = (0, node_path_1.join)(genesRoot, gene);
+        const phenotype = readJson((0, node_path_1.join)(geneDir, "phenotype.json"));
+        if (!phenotype) {
+            throw new GenomeExportError(`Gene '${gene}' has no readable phenotype.json under ${genesDir}/`, `Install or wrap it first: rotifer install ${gene}  or  rotifer wrap ${gene}`);
+        }
+        const idResult = (0, binding_js_1.geneIdV2)(genesRoot, gene);
+        if (!("id" in idResult)) {
+            throw new GenomeExportError(`Gene '${gene}' has no v2 gene ID: ${idResult.reason}`, hintForUncomputableId(gene, idResult.reason));
+        }
+        if (!genome_format_js_1.GENE_ID_V2.test(idResult.id)) {
+            throw new GenomeExportError(`Gene '${gene}' got a malformed v2 gene ID from the native module`);
+        }
+        refs.push({ geneId: idResult.id, role: gene, optional: false });
+        const fidelity = typeof phenotype.fidelity === "string" ? phenotype.fidelity : "";
+        const isWrapped = fidelity.toLowerCase() === "wrapped";
+        if (!input.lock) {
+            if (typeof phenotype.domain === "string" && phenotype.domain) {
+                capabilities[gene] = {
+                    domain: phenotype.domain,
+                    inputSchemaCompat: phenotype.inputSchema ?? {},
+                    outputSchemaCompat: phenotype.outputSchema ?? {},
+                    minFitness: input.minFitness ?? genome_format_js_1.DEFAULT_MIN_FITNESS,
+                };
+            }
+            else {
+                notices.push(`Gene '${gene}' declares no domain — the receiver can only import it by gene ID.`);
+            }
+        }
+        const manifest = readJson((0, node_path_1.join)(geneDir, ".cloud-manifest.json"));
+        const owner = manifest?.owner;
+        const version = manifest?.version;
+        let hasHints = false;
+        if (typeof owner === "string" && owner && typeof version === "string" && version && fidelity) {
+            hints[gene] = {
+                owner,
+                name: gene,
+                version,
+                ...(typeof manifest?.cloud_id === "string" && manifest.cloud_id ? { cloudId: manifest.cloud_id } : {}),
+                fidelity,
+            };
+            hasHints = true;
+        }
+        else {
+            notices.push(input.lock
+                ? `Gene '${gene}' was never published or installed from the Registry — the receiver has no way to fetch it.`
+                : `Gene '${gene}' was never published or installed from the Registry — the receiver can only find a substitute by capability.`);
+        }
+        if (isWrapped) {
+            notices.push(`Gene '${gene}' is Wrapped: in v0.9.2 the receiver cannot install Wrapped genes from the Registry ` +
+                "(their source is not distributed there), only find a Native/Hybrid substitute by capability.");
+        }
+        roles.push({ role: gene, geneId: idResult.id, fidelity, hasHints });
+    }
+    const { composition, parMerge } = buildComposition(agent, refs);
+    const extension = {};
+    if (parMerge !== undefined)
+        extension.parMerge = parMerge;
+    if (input.minVg !== undefined)
+        extension.minVg = input.minVg;
+    const now = (input.now ?? new Date()).toISOString();
+    const blueprint = {
+        blueprintFormat: genome_format_js_1.BLUEPRINT_FORMAT,
+        protocolVersion: { ...genome_format_js_1.BLUEPRINT_PROTOCOL_VERSION, supportedFeatures: ["GENE_COMPOSITION_ALGEBRA"] },
+        snapshot: { genes: refs, composition, snapshotAt: now },
+        metadata: {
+            name: agent.name,
+            ...(input.description ? { description: input.description } : {}),
+            ...(input.author ? { author: input.author } : {}),
+            createdAt: now,
+        },
+        ...(Object.keys(capabilities).length > 0 ? { capabilities } : {}),
+        ...(Object.keys(hints).length > 0 ? { resolutionHints: hints } : {}),
+        ...(Object.keys(extension).length > 0 ? { bindingExtensions: { [genome_format_js_1.BINDING_NAME]: extension } } : {}),
+    };
+    return { blueprint, roles, notices };
+}
+/**
+ * Build, scan, and write a Blueprint. Nothing is written when the scan finds
+ * anything, or when this CLI's own import would refuse the file: the reader's
+ * rules (Cond forms, numbers, strings, required fields) run on the exact text.
+ */
+function exportGenome(input) {
+    const { blueprint, roles, notices } = buildBlueprint(input);
+    const findings = (0, genome_format_js_1.scanBlueprint)(blueprint);
+    if (findings.length > 0) {
+        throw new GenomeExportError(`Credential scan blocked the export: ${findings.length} finding(s); nothing was written`, "Remove the flagged values (shown by position only) and export again.", findings);
+    }
+    const text = JSON.stringify(blueprint, null, 2) + "\n";
+    try {
+        (0, genome_format_js_1.parseBlueprint)(text);
+    }
+    catch (err) {
+        if (!(err instanceof genome_format_js_1.GenomeImportError))
+            throw err;
+        throw new GenomeExportError(`The Blueprint would not import, so nothing was written: ${err.message}`, err.hint);
+    }
+    (0, node_fs_1.writeFileSync)(input.output, text);
+    return {
+        file: input.output,
+        agent: input.agent.name,
+        composition: compositionTypeOf(input.agent),
+        geneCount: blueprint.snapshot.genes.length,
+        mode: blueprint.capabilities ? "capability" : "lock",
+        roles,
+        notices,
+        credentialScan: { passed: true, layers: ["key-name", "value-pattern", "entropy"] },
+    };
+}
+function parseNumberOption(flag, raw) {
+    if (raw === undefined)
+        return undefined;
+    const n = Number(raw);
+    if (raw.trim() === "" || !Number.isFinite(n))
+        throw new GenomeExportError(`${flag} must be a number, got '${raw}'`);
+    return n;
+}
+function reportFailure(err) {
+    if (display.isJsonMode()) {
+        process.stdout.write(JSON.stringify({ ok: false, error: err.message, hint: err.hint, findings: err.findings }, null, 2) + "\n");
+        return;
+    }
+    display.error(err.message, err.hint);
+    for (const f of err.findings ?? []) {
+        console.error(`    ${f.pointer || "/"}  [${f.layer}] ${f.rule}`);
+    }
+}
+/** Run `genome export`; returns the process exit code. */
+function runGenomeExport(agentRef, options, ctx) {
+    try {
+        const agent = findAgent(ctx.root, agentRef);
+        const output = (0, node_path_1.resolve)(options.output ?? `${agent.name}.rgenome`);
+        const result = exportGenome({
+            root: ctx.root,
+            genesDir: ctx.genesDir,
+            agent,
+            lock: options.lock,
+            minFitness: parseNumberOption("--min-fitness", options.minFitness),
+            minVg: parseNumberOption("--min-vg", options.minVg),
+            description: options.description,
+            author: ctx.author,
+            output,
+        });
+        display.renderResult({ ok: true, ...result }, (r) => {
+            display.header("Genome Export");
+            display.keyValue("Agent", r.agent);
+            display.keyValue("Composition", r.composition);
+            display.keyValue("Mode", r.mode === "lock" ? "lock (gene IDs only)" : "capability + gene IDs");
+            for (const role of r.roles) {
+                display.keyValue(`  ${role.role}`, `${role.geneId}  ${role.fidelity}${role.hasHints ? "" : "  (no Registry hints)"}`);
+            }
+            for (const n of r.notices)
+                display.warn(n);
+            display.success("Credential scan passed (key names, value patterns, entropy)");
+            display.success(`Wrote ${r.file}`);
+        });
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof GenomeExportError) {
+            reportFailure(err);
+            return 1;
+        }
+        throw err;
+    }
+}
+const genomeExportCommand = new commander_1.Command("export")
+    .description("Export an agent's genome as a shareable Blueprint (.rgenome)")
+    .argument("<agent>", "agent name or id")
+    .option("-o, --output <file>", "output file (default: <agent>.rgenome)")
+    .option("--lock", "reference genes by ID only; write no capability queries")
+    .option("--min-fitness <n>", `minimum fitness in each capability query (default: ${genome_format_js_1.DEFAULT_MIN_FITNESS})`)
+    .option("--min-vg <n>", `suggested minimum V(g) for importers, in [${genome_format_js_1.MIN_VG_FLOOR}, 1.0)`)
+    .option("-d, --description <text>", "description stored in the Blueprint metadata")
+    .action((agentRef, options) => {
+    const root = (0, project_root_js_1.requireProjectRoot)();
+    const config = (0, config_js_1.loadConfig)(root);
+    const author = (0, auth_js_1.loadCredentials)()?.user?.username;
+    process.exitCode = runGenomeExport(agentRef, options, { root, genesDir: config.genes_dir, author });
+});
+exports.genomeCommand = new commander_1.Command("genome")
+    .description("Genome Blueprint commands: export an agent's genome, import one")
+    .addCommand(genomeExportCommand);
+//# sourceMappingURL=genome.js.map

package/dist/commands/genome.js.map

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

package/dist/commands/install.d.ts

@@ -1,3 +1,57 @@
 import { Command } from "commander";
+import type { CloudGene } from "../cloud/types.js";
+/** The gene is already installed and `force` was not set. */
+export declare class GeneExistsError extends Error {
+    readonly geneName: string;
+    readonly geneDir: string;
+    constructor(geneName: string, geneDir: string);
+}
+/** The downloaded WASM does not match the size or hash the Registry recorded. */
+export declare class WasmIntegrityError extends Error {
+    constructor(message: string);
+}
+/**
+ * Whether a Registry row's phenotype and its recorded content_hash (the v1,
+ * client-defined hash) agree. Both come from the same row in the same
+ * response, so agreement says nothing about whether the content can be relied
+ * on — anyone able to change one can change the other, and some edits (a
+ * `__proto__` key) do not move the hash at all. Disagreement does say
+ * something: storage damage, a hash edited after publication, or one of the
+ * early-2026 rows known to differ.
+ */
+export type ContentHashCheck = {
+    status: "match";
+} | {
+    status: "mismatch";
+    recorded: string;
+    recomputed: string;
+} | {
+    status: "absent";
+};
+export declare function checkContentHash(gene: Pick<CloudGene, "phenotype" | "content_hash">): ContentHashCheck;
+/** The one-line notice for a mismatch. Deliberately makes no claim about trust. */
+export declare function contentHashWarning(geneName: string, check: ContentHashCheck): string | null;
+export interface InstallFromCloudOptions {
+    /** Absolute path of the workspace's genes directory. */
+    genesDir: string;
+    force?: boolean;
+    /** Print progress the way `rotifer install` does. */
+    isVerbose?: boolean;
+    /** Called once the gene's metadata has been fetched. */
+    onFetched?: (gene: CloudGene) => void;
+}
+export interface InstalledGene {
+    gene: CloudGene;
+    geneDir: string;
+    didSnapshot: boolean;
+    contentHashCheck: ContentHashCheck;
+}
+/**
+ * Install one gene from the Registry: phenotype.json, the WASM (size and
+ * SHA-256 checked against the Registry row), and `.cloud-manifest.json`.
+ * Counts the download, as every install does. Throws on any failure; nothing
+ * is printed unless `isVerbose`.
+ */
+export declare function installGeneFromCloud(geneRef: string, options: InstallFromCloudOptions): Promise<InstalledGene>;
 export declare const installCommand: Command;
 //# sourceMappingURL=install.d.ts.map

package/dist/commands/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,eAAO,MAAM,cAAc,SAwIvB,CAAC"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAOnD,6DAA6D;AAC7D,qBAAa,eAAgB,SAAQ,KAAK;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM;gBAA1C,QAAQ,EAAE,MAAM,EAAW,OAAO,EAAE,MAAM;CAIhE;AAED,iFAAiF;AACjF,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEzB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,cAAc,CAAC,GAAG,gBAAgB,CAMtG;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAO3F;AAED,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wDAAwD;IACxD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,aAAa,CAAC,CAyGxB;AAED,eAAO,MAAM,cAAc,SAwDvB,CAAC"}