aui-agent-builder 0.3.149 → 0.3.151

package/dist/commands/report.js

@@ -0,0 +1,169 @@
+/**
+ * report command — coding-agent feedback channel (BETA)
+ *
+ * The AUI CLI is in **beta**. Coding agents (Claude Code, Cursor, OpenCode)
+ * that drive it MUST use this command whenever they:
+ *   - hit an issue / error / unexpected behaviour with the CLI or the agent
+ *     they're building, OR
+ *   - learn something new about how the CLI / agent works that wasn't obvious
+ *     from the docs.
+ *
+ * Each report bundles metadata about the coding agent, the human user, the
+ * Apollo agent (the agent being built), and the organization, and sends it as
+ * ONE POST request to the AUI feedback endpoint. While we're in beta this is a
+ * placeholder webhook; it will be swapped for the real ingest endpoint later.
+ *
+ * The instruction to use this command is injected into every coding agent's
+ * prompt via the generated `report` skill (see
+ * `pull-schema.service.ts#writeReportSkill`), so agents discover it without
+ * the human having to tell them.
+ *
+ * Usage:
+ *   aui report "push failed with a confusing 500 and no detail"
+ *   aui report --type learning --message "version create clones the active bundle"
+ *   aui report -t issue -m "..." --agent claude
+ *   aui report -m "..." --dry-run     # print the payload, don't send
+ */
+import chalk from "chalk";
+import fetchWithTimeout from "../utils/fetch-with-timeout.js";
+import { loadSessionRaw, loadProjectConfig, loadEnvironment, } from "../config/index.js";
+/**
+ * Ingest endpoint for coding-agent reports — the agent-builder-bff
+ * `/api/reports` route, which validates and persists each report. Overridable
+ * via `AUI_REPORT_URL` for local testing / staging.
+ */
+export const REPORT_ENDPOINT = "https://agent-builder-bff-tawny.vercel.app/api/reports";
+/**
+ * Best-effort detection of which coding agent is driving the CLI.
+ *
+ * Order (first hit wins):
+ *   1. Explicit `--agent` flag.
+ *   2. `AUI_CODING_AGENT` env var (set by orchestrators / sandboxes).
+ *   3. Well-known per-tool env signatures.
+ *   4. "unknown" (likely a human at a terminal).
+ */
+export function detectCodingAgent(agentOption) {
+    const explicit = agentOption?.trim();
+    if (explicit)
+        return { name: explicit.toLowerCase(), detectedVia: "flag" };
+    const fromEnv = process.env.AUI_CODING_AGENT?.trim();
+    if (fromEnv)
+        return { name: fromEnv.toLowerCase(), detectedVia: "env:AUI_CODING_AGENT" };
+    if (process.env.CLAUDECODE || process.env.CLAUDE_CODE_ENTRYPOINT)
+        return { name: "claude", detectedVia: "env:CLAUDECODE" };
+    if (process.env.CURSOR_TRACE_ID || process.env.CURSOR_AGENT)
+        return { name: "cursor", detectedVia: "env:CURSOR" };
+    if (process.env.OPENCODE || process.env.OPENCODE_AGENT)
+        return { name: "opencode", detectedVia: "env:OPENCODE" };
+    return { name: "unknown", detectedVia: "fallback" };
+}
+/** Normalize an arbitrary `--type` value to a known ReportType. */
+export function normalizeReportType(value) {
+    return value?.trim().toLowerCase() === "learning" ? "learning" : "issue";
+}
+/** Parse `--context` as JSON when possible, else keep it as a raw string. */
+function parseContext(raw) {
+    if (raw === undefined)
+        return undefined;
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return undefined;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return trimmed;
+    }
+}
+/**
+ * Assemble the report payload from the current session, project, and runtime.
+ * Pure (modulo reading config files / env) so it can be unit-tested directly.
+ */
+export function buildReportPayload(options, cliVersion, deps) {
+    const session = deps?.session !== undefined ? deps.session : loadSessionRaw();
+    const project = deps?.projectConfig !== undefined
+        ? deps.projectConfig
+        : loadProjectConfig();
+    const environment = deps?.environment ?? loadEnvironment();
+    const message = (options.message ?? "").trim();
+    return {
+        beta: true,
+        source: "aui-cli",
+        type: normalizeReportType(options.type),
+        message,
+        context: parseContext(options.context),
+        timestamp: new Date().toISOString(),
+        codingAgent: detectCodingAgent(options.agent),
+        user: {
+            userId: session?.user_id,
+            email: session?.email,
+            name: session?.name,
+        },
+        organization: {
+            id: session?.organization_id ?? project?.organization_id,
+            name: session?.organization_name,
+        },
+        apolloAgent: {
+            code: project?.agent_code,
+            agentId: project?.agent_id,
+            agentManagementId: project?.agent_management_id ?? session?.agent_management_id,
+            networkId: session?.network_id,
+            networkName: session?.network_name,
+            versionId: project?.version_id ?? session?.version_id,
+            versionLabel: project?.version_label,
+            versionTag: project?.version_tag,
+        },
+        cli: {
+            version: cliVersion,
+            environment: String(environment),
+            sessionId: session?.cli_session_id ?? process.env.AUI_CLI_SESSION_ID,
+            platform: `${process.platform}/${process.arch}`,
+            nodeVersion: process.version,
+            cwd: process.cwd(),
+        },
+    };
+}
+/**
+ * `aui report` — gather metadata and POST a single coding-agent report.
+ */
+export async function report(messageArg, options = {}, cliVersion = "unknown") {
+    const merged = {
+        ...options,
+        message: options.message ?? messageArg,
+    };
+    if (!merged.message || !merged.message.trim()) {
+        console.log(chalk.yellow("\n  A report message is required."));
+        console.log(chalk.gray('  Usage: aui report "what happened or what you learned"'));
+        console.log(chalk.gray("         aui report --type learning --message \"...\"\n"));
+        return;
+    }
+    const payload = buildReportPayload(merged, cliVersion);
+    const endpoint = process.env.AUI_REPORT_URL || REPORT_ENDPOINT;
+    if (merged.dryRun) {
+        console.log(chalk.bold("\n  Report payload (dry run — not sent):\n"));
+        console.log(JSON.stringify(payload, null, 2));
+        console.log(chalk.gray(`\n  Would POST to: ${endpoint}\n`));
+        return;
+    }
+    try {
+        const res = await fetchWithTimeout(endpoint, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(payload),
+            timeoutMs: 15_000,
+        });
+        if (res.ok) {
+            console.log(chalk.green(`\n  ✓ Report sent (${payload.type}). Thanks — this helps us improve the beta CLI.\n`));
+        }
+        else {
+            console.log(chalk.yellow(`\n  ⚠ Report endpoint returned ${res.status}. Your report may not have been recorded.\n`));
+        }
+    }
+    catch (e) {
+        // Reporting must never break the agent's workflow — fail soft.
+        const msg = e instanceof Error ? e.message : String(e);
+        console.log(chalk.yellow(`\n  ⚠ Could not send report: ${msg}`));
+        console.log(chalk.gray("  This is non-fatal — continue with your task.\n"));
+    }
+}
+//# sourceMappingURL=report.js.map

package/dist/commands/report.js.map

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

package/dist/commands/util/agent-resolve.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Shared agent-management resolution.
+ *
+ * `aui push` and `aui version *` both need to turn a project's `.auirc`
+ * (and the active session) into the canonical agent-management `AgentInfo`
+ * that every version / draft / snapshot endpoint keys on. Historically the
+ * two commands resolved this independently and drifted: `push` preferred
+ * `.auirc.agent_management_id` (correct), while `version` only looked at
+ * `.auirc.agent_id` (the *network* id) and, on any miss, silently fell
+ * through to the session's "current" agent — creating drafts on the wrong
+ * agent and repointing foreign `.auirc` files. This helper is the single
+ * source of truth so the two paths can't diverge again.
+ *
+ * Resolution order (highest priority first):
+ *   1. project `agent_management_id` → `getAgent` directly (one round-trip).
+ *   2. project `agent_id` (network id) → `listAgents` filtered by
+ *      `network_id` OR `network_category_id` (covers template-imported
+ *      projects whose persisted id is actually the category id).
+ *   3. session `agent_management_id` → `getAgent`.
+ *   4. session `network_id` (if different) → same OR'd `listAgents` filter.
+ *
+ * Each attempt records its failure in `errors` so callers can surface the
+ * full picture instead of silently dropping the target agent.
+ */
+import type { AUIClient, AgentInfo } from "../../api-client/index.js";
+export interface AgentResolveInputs {
+    /** `.auirc.agent_management_id` — the canonical agent-management UUID. */
+    projectAgentManagementId?: string;
+    /**
+     * `.auirc.agent_id` — historically the network id. Also matched against
+     * `network_category_id` for template-imported projects.
+     */
+    projectNetworkId?: string;
+    /** `session.agent_management_id` fallback. */
+    sessionAgentManagementId?: string;
+    /** `session.network_id` fallback. */
+    sessionNetworkId?: string;
+}
+export interface AgentResolveResult {
+    /** The resolved agent, or `undefined` if no input id matched. */
+    agentInfo?: AgentInfo;
+    /**
+     * One human-readable line per failed attempt (throws / no-match), in the
+     * order they were tried. Empty on a clean first-try hit. Callers surface
+     * these in error messages and `AUI_DEBUG` output instead of silently
+     * dropping the target agent.
+     */
+    errors: string[];
+}
+/**
+ * Resolve a project's `.auirc` (and, optionally, the active session) into the
+ * canonical agent-management `AgentInfo` that every version / draft / snapshot
+ * / push endpoint keys on. Shared by `aui push` and `aui version *` so the two
+ * commands always target the same agent.
+ *
+ * Resolution order (first match wins; later steps run only if earlier ones
+ * yield nothing):
+ *   1. `projectAgentManagementId` → direct `getAgent(id)` (one round-trip,
+ *      no list scan). This is the canonical UUID and the preferred path.
+ *   2. `projectNetworkId` → `listAgents` filtered by `network_id` **OR**
+ *      `network_category_id`, matched against `scope.network_id`,
+ *      `scope.network_category_id`, or `id`. The dual filter makes the
+ *      legacy `.auirc.agent_id` robust to template-imported projects, where
+ *      the persisted id is actually the category id.
+ *   3. `sessionAgentManagementId` → direct `getAgent(id)`.
+ *   4. `sessionNetworkId` (only when different from `projectNetworkId`) →
+ *      same OR'd `listAgents` filter as step 2.
+ *
+ * Pass only the project inputs to resolve strictly within a project (no
+ * session fallback); pass session inputs too to allow the session fallback.
+ *
+ * This function NEVER throws and NEVER prompts — it performs read-only
+ * lookups and reports failures via `result.errors`. Callers decide whether an
+ * empty `agentInfo` is fatal. Each failed attempt is also logged to stderr
+ * when `AUI_DEBUG` is set.
+ *
+ * @param client  Authenticated `AUIClient` (its org/account scope is used for
+ *                the `listAgents` calls).
+ * @param inputs  Candidate ids from `.auirc` and/or the session. All optional;
+ *                omitted ids skip their step.
+ * @returns       `{ agentInfo, errors }` — `agentInfo` is the first match (or
+ *                `undefined`), `errors` lists every failed attempt in order.
+ *
+ * @example
+ * // Project-scoped (no session fallback) — used by `aui version *`:
+ * const { agentInfo, errors } = await resolveAgentManagementInfo(client, {
+ *   projectAgentManagementId: projectConfig.agent_management_id,
+ *   projectNetworkId: projectConfig.agent_id,
+ * });
+ * if (!agentInfo) throw new CLIError("Could not resolve the agent (.auirc).");
+ *
+ * @example
+ * // With session fallback — used by `aui push`:
+ * const { agentInfo } = await resolveAgentManagementInfo(client, {
+ *   projectAgentManagementId: projectConfig.agent_management_id,
+ *   projectNetworkId: projectConfig.agent_id,
+ *   sessionAgentManagementId: session.agent_management_id,
+ *   sessionNetworkId: session.network_id,
+ * });
+ */
+export declare function resolveAgentManagementInfo(client: AUIClient, inputs: AgentResolveInputs): Promise<AgentResolveResult>;
+//# sourceMappingURL=agent-resolve.d.ts.map

package/dist/commands/util/agent-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-resolve.d.ts","sourceRoot":"","sources":["../../../src/commands/util/agent-resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAsH7B"}

package/dist/commands/util/agent-resolve.js

@@ -0,0 +1,148 @@
+/**
+ * Shared agent-management resolution.
+ *
+ * `aui push` and `aui version *` both need to turn a project's `.auirc`
+ * (and the active session) into the canonical agent-management `AgentInfo`
+ * that every version / draft / snapshot endpoint keys on. Historically the
+ * two commands resolved this independently and drifted: `push` preferred
+ * `.auirc.agent_management_id` (correct), while `version` only looked at
+ * `.auirc.agent_id` (the *network* id) and, on any miss, silently fell
+ * through to the session's "current" agent — creating drafts on the wrong
+ * agent and repointing foreign `.auirc` files. This helper is the single
+ * source of truth so the two paths can't diverge again.
+ *
+ * Resolution order (highest priority first):
+ *   1. project `agent_management_id` → `getAgent` directly (one round-trip).
+ *   2. project `agent_id` (network id) → `listAgents` filtered by
+ *      `network_id` OR `network_category_id` (covers template-imported
+ *      projects whose persisted id is actually the category id).
+ *   3. session `agent_management_id` → `getAgent`.
+ *   4. session `network_id` (if different) → same OR'd `listAgents` filter.
+ *
+ * Each attempt records its failure in `errors` so callers can surface the
+ * full picture instead of silently dropping the target agent.
+ */
+/**
+ * Resolve a project's `.auirc` (and, optionally, the active session) into the
+ * canonical agent-management `AgentInfo` that every version / draft / snapshot
+ * / push endpoint keys on. Shared by `aui push` and `aui version *` so the two
+ * commands always target the same agent.
+ *
+ * Resolution order (first match wins; later steps run only if earlier ones
+ * yield nothing):
+ *   1. `projectAgentManagementId` → direct `getAgent(id)` (one round-trip,
+ *      no list scan). This is the canonical UUID and the preferred path.
+ *   2. `projectNetworkId` → `listAgents` filtered by `network_id` **OR**
+ *      `network_category_id`, matched against `scope.network_id`,
+ *      `scope.network_category_id`, or `id`. The dual filter makes the
+ *      legacy `.auirc.agent_id` robust to template-imported projects, where
+ *      the persisted id is actually the category id.
+ *   3. `sessionAgentManagementId` → direct `getAgent(id)`.
+ *   4. `sessionNetworkId` (only when different from `projectNetworkId`) →
+ *      same OR'd `listAgents` filter as step 2.
+ *
+ * Pass only the project inputs to resolve strictly within a project (no
+ * session fallback); pass session inputs too to allow the session fallback.
+ *
+ * This function NEVER throws and NEVER prompts — it performs read-only
+ * lookups and reports failures via `result.errors`. Callers decide whether an
+ * empty `agentInfo` is fatal. Each failed attempt is also logged to stderr
+ * when `AUI_DEBUG` is set.
+ *
+ * @param client  Authenticated `AUIClient` (its org/account scope is used for
+ *                the `listAgents` calls).
+ * @param inputs  Candidate ids from `.auirc` and/or the session. All optional;
+ *                omitted ids skip their step.
+ * @returns       `{ agentInfo, errors }` — `agentInfo` is the first match (or
+ *                `undefined`), `errors` lists every failed attempt in order.
+ *
+ * @example
+ * // Project-scoped (no session fallback) — used by `aui version *`:
+ * const { agentInfo, errors } = await resolveAgentManagementInfo(client, {
+ *   projectAgentManagementId: projectConfig.agent_management_id,
+ *   projectNetworkId: projectConfig.agent_id,
+ * });
+ * if (!agentInfo) throw new CLIError("Could not resolve the agent (.auirc).");
+ *
+ * @example
+ * // With session fallback — used by `aui push`:
+ * const { agentInfo } = await resolveAgentManagementInfo(client, {
+ *   projectAgentManagementId: projectConfig.agent_management_id,
+ *   projectNetworkId: projectConfig.agent_id,
+ *   sessionAgentManagementId: session.agent_management_id,
+ *   sessionNetworkId: session.network_id,
+ * });
+ */
+export async function resolveAgentManagementInfo(client, inputs) {
+    const { projectAgentManagementId, projectNetworkId, sessionAgentManagementId, sessionNetworkId, } = inputs;
+    let agentInfo;
+    const errors = [];
+    // 1) project agent_management_id → direct getAgent.
+    if (projectAgentManagementId) {
+        try {
+            agentInfo = await client.agentManagement.getAgent(projectAgentManagementId);
+        }
+        catch (err) {
+            errors.push(`getAgent(${projectAgentManagementId}) threw: ${err instanceof Error ? err.message : String(err)}`);
+            if (process.env.AUI_DEBUG) {
+                console.warn(`[debug] resolveAgentManagementInfo: getAgent(${projectAgentManagementId}) failed (stale id?):`, err instanceof Error ? err.message : err);
+            }
+        }
+    }
+    // 2) project network id → listAgents (network_id OR network_category_id).
+    if (!agentInfo && projectNetworkId) {
+        try {
+            const resp = await client.agentManagement.listAgents(client.getOrganizationId(), 1, 50, {
+                network_id: projectNetworkId,
+                network_category_id: projectNetworkId,
+            });
+            agentInfo = resp.items.find((a) => a.scope.network_id === projectNetworkId ||
+                a.scope.network_category_id === projectNetworkId ||
+                a.id === projectNetworkId);
+            if (!agentInfo) {
+                errors.push(`listAgents(network_id|network_category_id=${projectNetworkId}) returned ${resp.items.length} item(s), none matched.`);
+            }
+        }
+        catch (err) {
+            errors.push(`listAgents(network_id|network_category_id=${projectNetworkId}) threw: ${err instanceof Error ? err.message : String(err)}`);
+            if (process.env.AUI_DEBUG) {
+                console.warn(`[debug] resolveAgentManagementInfo: listAgents(network_id|network_category_id=${projectNetworkId}) failed:`, err instanceof Error ? err.message : err);
+            }
+        }
+    }
+    // 3) session agent_management_id → direct getAgent.
+    if (!agentInfo && sessionAgentManagementId) {
+        try {
+            agentInfo = await client.agentManagement.getAgent(sessionAgentManagementId);
+        }
+        catch (err) {
+            errors.push(`getAgent(${sessionAgentManagementId}) threw: ${err instanceof Error ? err.message : String(err)}`);
+            if (process.env.AUI_DEBUG) {
+                console.warn(`[debug] resolveAgentManagementInfo: getAgent(${sessionAgentManagementId}) failed (stale id?):`, err instanceof Error ? err.message : err);
+            }
+        }
+    }
+    // 4) session network id (if different) → same OR'd listAgents filter.
+    if (!agentInfo && sessionNetworkId && sessionNetworkId !== projectNetworkId) {
+        try {
+            const resp = await client.agentManagement.listAgents(client.getOrganizationId(), 1, 50, {
+                network_id: sessionNetworkId,
+                network_category_id: sessionNetworkId,
+            });
+            agentInfo = resp.items.find((a) => a.scope.network_id === sessionNetworkId ||
+                a.scope.network_category_id === sessionNetworkId ||
+                a.id === sessionNetworkId);
+            if (!agentInfo) {
+                errors.push(`listAgents(network_id|network_category_id=${sessionNetworkId}) returned ${resp.items.length} item(s), none matched.`);
+            }
+        }
+        catch (err) {
+            errors.push(`listAgents(network_id|network_category_id=${sessionNetworkId}) threw: ${err instanceof Error ? err.message : String(err)}`);
+            if (process.env.AUI_DEBUG) {
+                console.warn(`[debug] resolveAgentManagementInfo: listAgents(network_id|network_category_id=${sessionNetworkId}) failed:`, err instanceof Error ? err.message : err);
+            }
+        }
+    }
+    return { agentInfo, errors };
+}
+//# sourceMappingURL=agent-resolve.js.map

package/dist/commands/util/agent-resolve.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/commands/version.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH,OAAO,KAAK,EAGV,gBAAgB,EAGjB,MAAM,wBAAwB,CAAC;AAsNhC,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAgEjD;AAID,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmJlG;AAID,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;IAChD,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA2RnG;AAID,wBAAsB,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkE1F;AAID,wBAAsB,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0D9F;AAID,wBAAsB,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkE/F;AAID,wBAAsB,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoD9F;AAID,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqE5G"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/commands/version.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH,OAAO,KAAK,EAGV,gBAAgB,EAGjB,MAAM,wBAAwB,CAAC;AA+OhC,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAgEjD;AAID,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmJlG;AAID,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;IAChD,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAsNnG;AAID,wBAAsB,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkE1F;AAID,wBAAsB,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0D9F;AAID,wBAAsB,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkE/F;AAID,wBAAsB,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoD9F;AAID,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqE5G"}