@meshy-ai/cli 0.1.0

package/dist/internal/update-notifier.js

@@ -0,0 +1,445 @@
+/**
+ * Update notifier — two-channel design.
+ *
+ * Channel 1 (agents / machines): JSON outputs carry `_notice.update` when a
+ * newer version is available. Injected by attachUpdateNotice() in output.ts
+ * and report.ts.
+ *
+ * Channel 2 (humans on TTY): a single stderr line printed by
+ * printHumanUpdateHint() after emit() renders its output.
+ *
+ * Hard rule: this module MUST NEVER slow down, hang, or break the main
+ * command. Network I/O runs in a detached child process (see refreshCache)
+ * so a hung registry cannot delay process exit. All public functions are
+ * synchronous and read only from the local cache file.
+ */
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { spawn } from "node:child_process";
+import { VERSION } from "./version.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const REGISTRY_URL = "https://registry.npmjs.org/meshy-cli/latest";
+export const FETCH_TIMEOUT_MS = 15_000;
+export const MAX_RESPONSE_BYTES = 256 * 1024;
+export const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+export const UPDATE_COMMAND = "npm i -g meshy-cli@latest";
+/**
+ * Hidden self-command used for the detached background refresh child.
+ * CRITICAL: the child must check argv for this token and return immediately
+ * to prevent an infinite spawn chain.
+ */
+export const REFRESH_COMMAND = "__refresh-update-cache";
+/** Opt-out env var. Any non-empty value disables all update checks. */
+const NO_UPDATE_VAR = "MESHY_CLI_NO_UPDATE_NOTIFIER";
+/** CI environment variables — any non-empty value triggers skip. */
+const CI_VARS = ["CI", "GITHUB_ACTIONS", "BUILD_NUMBER", "RUN_ID"];
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+/** Returns the path to the update-state cache file. */
+export function stateFilePath() {
+    return join(homedir(), ".config", "meshy", "update-state.json");
+}
+// ---------------------------------------------------------------------------
+// shouldSkip
+// ---------------------------------------------------------------------------
+/**
+ * Returns true when the update check should be skipped entirely.
+ * Skips when:
+ *   - MESHY_CLI_NO_UPDATE_NOTIFIER is a non-empty string
+ *   - any CI env var (CI, GITHUB_ACTIONS, BUILD_NUMBER, RUN_ID) is non-empty
+ *   - version contains "-dev"
+ *   - version matches a git-describe suffix (e.g. 0.1.0-5-gdeadbee)
+ */
+export function shouldSkip(env = process.env, version = VERSION) {
+    if (env[NO_UPDATE_VAR])
+        return true;
+    for (const v of CI_VARS) {
+        if (env[v])
+            return true;
+    }
+    if (version.includes("-dev"))
+        return true;
+    if (/-\d+-g[0-9a-f]{7,}/.test(version))
+        return true;
+    return false;
+}
+// ---------------------------------------------------------------------------
+// compareVersions
+// ---------------------------------------------------------------------------
+/**
+ * Semver 2.0.0-compliant comparison. Returns -1 if a < b, 0 if equal, 1 if a > b.
+ *
+ * Rules:
+ *   - strips leading "v"
+ *   - strips "+build" metadata (build metadata is ignored per semver §10)
+ *   - splits prerelease on first "-"
+ *   - compares numeric major/minor/patch (missing segments → 0, non-numeric → 0)
+ *   - equal numerics: release > prerelease (semver §11.3)
+ *   - both prereleases: compare dot-separated identifiers left-to-right (semver §11.4):
+ *       numeric identifiers compare numerically
+ *       alphanumeric identifiers compare lexically (ASCII)
+ *       numeric < alphanumeric
+ *       if all shared identifiers equal, shorter set has LOWER precedence
+ */
+export function compareVersions(a, b) {
+    const parse = (v) => {
+        // strip leading v
+        let s = v.startsWith("v") ? v.slice(1) : v;
+        // strip build metadata (ignored per semver §10)
+        const plusIdx = s.indexOf("+");
+        if (plusIdx !== -1)
+            s = s.slice(0, plusIdx);
+        // split prerelease on first "-"
+        const dashIdx = s.indexOf("-");
+        let core;
+        let pre;
+        if (dashIdx !== -1) {
+            core = s.slice(0, dashIdx);
+            pre = s.slice(dashIdx + 1).split(".");
+        }
+        else {
+            core = s;
+            pre = null;
+        }
+        const parts = core.split(".");
+        const nums = [0, 1, 2].map((i) => {
+            const n = parseInt(parts[i] ?? "0", 10);
+            return isNaN(n) ? 0 : n;
+        });
+        return { nums, pre };
+    };
+    const pa = parse(a);
+    const pb = parse(b);
+    // Compare major/minor/patch numerically
+    for (let i = 0; i < 3; i++) {
+        const na = pa.nums[i];
+        const nb = pb.nums[i];
+        if (na < nb)
+            return -1;
+        if (na > nb)
+            return 1;
+    }
+    // numeric parts equal — compare prerelease (semver §11.3 and §11.4)
+    if (pa.pre === null && pb.pre === null)
+        return 0;
+    if (pa.pre === null)
+        return 1; // release > prerelease
+    if (pb.pre === null)
+        return -1; // prerelease < release
+    // Both have prerelease — compare dot-separated identifiers left-to-right
+    const len = Math.max(pa.pre.length, pb.pre.length);
+    for (let i = 0; i < len; i++) {
+        const ia = pa.pre[i];
+        const ib = pb.pre[i];
+        // Shorter set has lower precedence (semver §11.4.4)
+        if (ia === undefined)
+            return -1;
+        if (ib === undefined)
+            return 1;
+        const na = /^\d+$/.test(ia) ? parseInt(ia, 10) : NaN;
+        const nb = /^\d+$/.test(ib) ? parseInt(ib, 10) : NaN;
+        if (!isNaN(na) && !isNaN(nb)) {
+            // Both numeric — compare numerically
+            if (na < nb)
+                return -1;
+            if (na > nb)
+                return 1;
+        }
+        else if (!isNaN(na)) {
+            // Numeric < alphanumeric (semver §11.4.1)
+            return -1;
+        }
+        else if (!isNaN(nb)) {
+            return 1;
+        }
+        else {
+            // Both alphanumeric — compare lexically (ASCII)
+            if (ia < ib)
+                return -1;
+            if (ia > ib)
+                return 1;
+        }
+    }
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// buildNotice
+// ---------------------------------------------------------------------------
+/**
+ * Returns an UpdateNotice if latest > current, otherwise null.
+ */
+export function buildNotice(latest, current = VERSION) {
+    if (compareVersions(latest, current) <= 0)
+        return null;
+    return {
+        current,
+        latest,
+        message: `meshy-cli ${latest} available (current ${current}), run: ${UPDATE_COMMAND}`,
+        command: UPDATE_COMMAND,
+    };
+}
+// ---------------------------------------------------------------------------
+// checkCached
+// ---------------------------------------------------------------------------
+/**
+ * Pure read from the cache file — no network, no TTL check.
+ *
+ * Note: a newer-version fact does not expire. TTL gates only the network
+ * refresh (isCacheStale). Once we know a newer version exists, we keep
+ * surfacing the notice until the user upgrades.
+ *
+ * Returns null on missing/corrupt file, missing latest_version, or when
+ * latest is not newer than current. Never throws.
+ */
+export function checkCached(stateFile = stateFilePath(), current = VERSION) {
+    try {
+        const raw = readFileSync(stateFile, "utf8");
+        const state = JSON.parse(raw);
+        if (typeof state.latest_version !== "string" || !state.latest_version)
+            return null;
+        return buildNotice(state.latest_version, current);
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// isCacheStale
+// ---------------------------------------------------------------------------
+/**
+ * Returns true when the cache is missing, corrupt, has no checked_at, or
+ * is older than CACHE_TTL_MS.
+ */
+export function isCacheStale(stateFile = stateFilePath(), now = Date.now()) {
+    try {
+        const raw = readFileSync(stateFile, "utf8");
+        const state = JSON.parse(raw);
+        if (typeof state.checked_at !== "number")
+            return true;
+        if (state.checked_at > now)
+            return true; // clock-skewed or corrupt future timestamp
+        return now - state.checked_at > CACHE_TTL_MS;
+    }
+    catch {
+        return true;
+    }
+}
+// ---------------------------------------------------------------------------
+// getUpdateNotice
+// ---------------------------------------------------------------------------
+/**
+ * Returns the cached update notice if applicable, or null.
+ * This is what emit() and report paths call — synchronous, never throws.
+ */
+export function getUpdateNotice() {
+    if (shouldSkip())
+        return null;
+    return checkCached();
+}
+// ---------------------------------------------------------------------------
+// attachUpdateNotice
+// ---------------------------------------------------------------------------
+/**
+ * Merges the update notice into an existing `_notice` value.
+ * If existing is a plain object, spreads it and adds `update`.
+ * If existing is a non-object (string/number/array/null/undefined), replaces it.
+ */
+function mergeNotice(existing, notice) {
+    if (existing !== null && existing !== undefined && typeof existing === "object" && !Array.isArray(existing)) {
+        return { ...existing, update: notice };
+    }
+    return { update: notice };
+}
+/**
+ * Injects the update notice into a value before JSON serialization.
+ *
+ * Injection rules:
+ *   - notice null → value unchanged
+ *   - format "pretty" → unchanged (humans get the stderr line instead)
+ *   - Array + format "ndjson": if non-empty and first element is a plain
+ *     object, return new array with first element replaced by
+ *     { ...first, _notice: { update: notice } }. Attaches ONCE on the first
+ *     line only — never per-line.
+ *   - Array + any other format (e.g. "json") → unchanged. A JSON array has
+ *     no clean metadata slot without breaking the schema, so we leave it alone.
+ *   - plain object → { ...value, _notice: { update: notice } }
+ *   - anything else (string/number/null) → unchanged
+ */
+export function attachUpdateNotice(value, format, notice) {
+    if (notice === null)
+        return value;
+    if (format === "pretty")
+        return value;
+    if (Array.isArray(value)) {
+        if (format === "ndjson" && value.length > 0) {
+            const first = value[0];
+            if (first !== null && typeof first === "object" && !Array.isArray(first)) {
+                const decorated = { ...first, _notice: mergeNotice(first["_notice"], notice) };
+                return [decorated, ...value.slice(1)];
+            }
+        }
+        return value;
+    }
+    if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+        const obj = value;
+        return { ...obj, _notice: mergeNotice(obj["_notice"], notice) };
+    }
+    return value;
+}
+// ---------------------------------------------------------------------------
+// printHumanUpdateHint
+// ---------------------------------------------------------------------------
+/**
+ * Writes the update message to stderr ONLY when all three of
+ * io.stdout/io.stderr/io.stdin have truthy isTTY (i.e. a fully interactive
+ * terminal). NEVER writes to stdout — stdout must stay machine-parseable.
+ *
+ * Returns true if the hint was written, false otherwise.
+ */
+export function printHumanUpdateHint(notice, io) {
+    if (!notice)
+        return false;
+    if (!io.stdout.isTTY || !io.stderr.isTTY || !io.stdin.isTTY)
+        return false;
+    io.stderr.write(`${notice.message}\n`);
+    return true;
+}
+// ---------------------------------------------------------------------------
+// writeState
+// ---------------------------------------------------------------------------
+/**
+ * Atomically writes the update state to disk.
+ * Uses a tmp file + rename to avoid torn JSON from concurrent CLI runs.
+ */
+export function writeState(state, file = stateFilePath()) {
+    mkdirSync(dirname(file), { recursive: true });
+    const tmp = `${file}.tmp-${process.pid}`;
+    writeFileSync(tmp, JSON.stringify(state), "utf8");
+    renameSync(tmp, file);
+}
+// ---------------------------------------------------------------------------
+// fetchLatestVersion
+// ---------------------------------------------------------------------------
+/**
+ * Fetches the latest version from the npm registry.
+ * Throws on any failure — callers must swallow.
+ */
+export async function fetchLatestVersion(registryUrl = REGISTRY_URL, timeoutMs = FETCH_TIMEOUT_MS) {
+    const res = await fetch(registryUrl, {
+        signal: AbortSignal.timeout(timeoutMs),
+        headers: { accept: "application/json" },
+    });
+    if (!res.ok) {
+        throw new Error(`registry responded ${res.status}`);
+    }
+    // Read body with a hard 256KB cap
+    let parsed;
+    if (res.body) {
+        const reader = res.body.getReader();
+        const chunks = [];
+        let total = 0;
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (value) {
+                total += value.length;
+                if (total > MAX_RESPONSE_BYTES) {
+                    await reader.cancel();
+                    throw new Error("registry response too large");
+                }
+                chunks.push(value);
+            }
+        }
+        const combined = new Uint8Array(total);
+        let offset = 0;
+        for (const chunk of chunks) {
+            combined.set(chunk, offset);
+            offset += chunk.length;
+        }
+        const text = new TextDecoder().decode(combined);
+        parsed = JSON.parse(text);
+    }
+    else {
+        const text = await res.text();
+        if (text.length > MAX_RESPONSE_BYTES) {
+            throw new Error("registry response too large");
+        }
+        parsed = JSON.parse(text);
+    }
+    if (typeof parsed.version !== "string" || !parsed.version) {
+        throw new Error("registry response missing version field");
+    }
+    return parsed.version;
+}
+// ---------------------------------------------------------------------------
+// runRefreshCommand
+// ---------------------------------------------------------------------------
+/**
+ * Entry point for the hidden background child command.
+ * Fetches the latest version and writes it to the cache.
+ * Must never throw — the child always exits 0.
+ */
+export async function runRefreshCommand() {
+    if (shouldSkip())
+        return;
+    try {
+        // @internal: MESHY_CLI_UPDATE_REGISTRY_URL is a test hook — not documented
+        const url = process.env["MESHY_CLI_UPDATE_REGISTRY_URL"] ?? REGISTRY_URL;
+        const latest = await fetchLatestVersion(url);
+        writeState({ latest_version: latest, checked_at: Date.now() });
+    }
+    catch {
+        // swallow: offline / 500 / timeout / corrupt must never surface
+        // On failure write NOTHING — next stale invocation retries
+    }
+}
+// ---------------------------------------------------------------------------
+// refreshCache
+// ---------------------------------------------------------------------------
+/**
+ * Fire-and-forget spawner. Spawns a detached child process to refresh the
+ * update cache in the background. NEVER throws, never awaits anything.
+ *
+ * Why a detached child instead of in-process fetch:
+ *   An in-flight undici/fetch keeps the Node event loop alive, so an
+ *   in-process fire-and-forget fetch would delay process exit by up to the
+ *   15s timeout — violating "never slow down the main command". A detached
+ *   child is fully independent and the parent can exit immediately.
+ */
+export function refreshCache(deps) {
+    try {
+        const env = deps?.env ?? process.env;
+        const argv = deps?.argv ?? process.argv;
+        const scriptPath = deps?.scriptPath ?? process.argv[1];
+        const stateFile = deps?.stateFile ?? stateFilePath();
+        const spawnImpl = deps?.spawnImpl ?? spawn;
+        // 1. Skip if opted out or CI
+        if (shouldSkip(env))
+            return;
+        // 2. CRITICAL: prevent infinite spawn chain — if we ARE the child, return
+        if (argv.includes(REFRESH_COMMAND))
+            return;
+        // 3. Skip if cache is still fresh
+        if (!isCacheStale(stateFile))
+            return;
+        // 4. Need a script path to spawn
+        if (!scriptPath)
+            return;
+        // 5. Spawn detached child
+        const child = spawnImpl(process.execPath, [scriptPath, REFRESH_COMMAND], {
+            detached: true,
+            stdio: "ignore",
+        });
+        child.on("error", () => { });
+        child.unref();
+    }
+    catch {
+        // Never propagate — this is fire-and-forget
+    }
+}
+//# sourceMappingURL=update-notifier.js.map

package/dist/internal/update-notifier.js.map

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

package/dist/internal/user-agent.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shared User-Agent string for all outbound HTTP requests (API calls and
+ * OAuth token exchanges). Format: meshy-cli/0.1.0 (darwin arm64; node v22.1.0)
+ */
+export declare const USER_AGENT: string;
+//# sourceMappingURL=user-agent.d.ts.map

package/dist/internal/user-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-agent.d.ts","sourceRoot":"","sources":["../../src/internal/user-agent.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAwF,CAAC"}

package/dist/internal/user-agent.js

@@ -0,0 +1,7 @@
+import { VERSION } from "./version.js";
+/**
+ * Shared User-Agent string for all outbound HTTP requests (API calls and
+ * OAuth token exchanges). Format: meshy-cli/0.1.0 (darwin arm64; node v22.1.0)
+ */
+export const USER_AGENT = `meshy-cli/${VERSION} (${process.platform} ${process.arch}; node ${process.version})`;
+//# sourceMappingURL=user-agent.js.map

package/dist/internal/user-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-agent.js","sourceRoot":"","sources":["../../src/internal/user-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,OAAO,KAAK,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,UAAU,OAAO,CAAC,OAAO,GAAG,CAAC"}

package/dist/internal/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/internal/version.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,OAAO,QAAU,CAAC"}

package/dist/internal/version.js

@@ -0,0 +1,11 @@
+import { readFileSync } from "node:fs";
+/**
+ * package.json is the single source of truth for the version — read it at
+ * startup instead of hardcoding. This file sits exactly two directories
+ * below package.json in both layouts that matter (src/internal/ under tsx,
+ * dist/internal/ after `tsc`), and tests/version.test.ts pins VERSION ===
+ * package.json#version so the two can never drift again.
+ */
+const { version } = JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf8"));
+export const VERSION = version;
+//# sourceMappingURL=version.js.map

package/dist/internal/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/internal/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC9C,CAAC;AAEzB,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/root.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Root command. Wires global flags and attaches every subcommand.
+ *
+ * The per-endpoint commands are registered but hidden from the root help.
+ * They remain fully supported — `meshy resources` indexes them and
+ * `meshy <resource> --help` documents each one. The root help leads with the
+ * short list instead, because it is read on every invocation (an agent pays
+ * for the whole surface each time it runs `--help`), and because a caller who
+ * wants one model should not have to pick an endpoint first.
+ */
+import { Command } from "commander";
+export declare function buildRootCommand(): Command;
+//# sourceMappingURL=root.d.ts.map

package/dist/root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../src/root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkGpC,wBAAgB,gBAAgB,IAAI,OAAO,CAiD1C"}