@neta-art/cohub-cli 6.7.0 → 6.8.1

package/dist/commands/spaces.js

@@ -1,10 +1,10 @@
 import { randomUUID } from "node:crypto";
-import { createReadStream } from "node:fs";
 import { readdir, stat } from "node:fs/promises";
 import { basename, dirname, relative, resolve, sep } from "node:path";
 import { resolveCohubEnvironment } from "@neta-art/cohub";
 import { uploadAvatarAsset, uploadChatImageAsset } from "../avatar.js";
 import { createClient } from "../client.js";
+import { putLocalFile } from "../http-put.js";
 import { table, json as outJson, jsonRequested, ok, error, handleHttp, formatEpochMs } from "../output.js";
 import { resolveSpace } from "../space.js";
 import { registerSpaceCommerce } from "./space-commerce.js";
@@ -156,19 +156,16 @@ export async function collectUploadFiles(paths) {
     return files;
 }
 async function putUploadEntry(entry, uploadUrl, headers) {
-    const response = await fetch(uploadUrl, {
-        method: "PUT",
+    await putLocalFile({
+        url: uploadUrl,
+        filePath: entry.localPath,
+        size: entry.size,
         headers,
-        body: createReadStream(entry.localPath),
-        duplex: "half",
+        label: entry.relativePath,
     });
-    if (!response.ok) {
-        const detail = await response.text().catch(() => "");
-        throw new Error(`Failed to upload ${entry.relativePath}: HTTP ${response.status}${detail ? ` — ${detail}` : ""}`);
-    }
 }
 async function uploadFiles(command, paths, opts) {
-    const spaceId = resolveSpace(command);
+    const spaceId = await resolveSpace(command);
     const client = createClient();
     try {
         const files = await collectUploadFiles(paths);
@@ -242,7 +239,7 @@ async function sendPrompt(command, words, opts) {
         && !new Set(["off", "minimal", "low", "medium", "high", "xhigh", "max"]).has(thinkingLevel)) {
         return error("Invalid thinking level", "Use off|minimal|low|medium|high|xhigh|max");
     }
-    const spaceId = resolveSpace(command);
+    const spaceId = await resolveSpace(command);
     const client = createClient();
     try {
         const schedule = opts.delayMs
@@ -304,7 +301,7 @@ async function sendPrompt(command, words, opts) {
     }
 }
 async function runCompletionCommand(command, words, opts) {
-    const spaceId = resolveSpace(command);
+    const spaceId = await resolveSpace(command);
     const content = words.join(" ").trim();
     if (!content && process.stdin.isTTY) {
         return error("Message required", "Pass content args or pipe via stdin");
@@ -490,7 +487,7 @@ export function registerSpaces(program) {
         .description("Show space details")
         .option("--json", "Output as JSON")
         .action(async (id, opts) => {
-        const spaceId = id?.trim() || resolveSpace(spacesCmd);
+        const spaceId = id?.trim() || await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const space = await client.spaces.get(spaceId);
@@ -562,7 +559,7 @@ export function registerSpaces(program) {
         .description("Upload the space avatar")
         .option("--json", "Output as JSON")
         .action(async (path, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const asset = await uploadAvatarAsset({ client, purpose: "space_avatar", spaceId, path });
@@ -699,7 +696,7 @@ export function registerSpaces(program) {
         .description("Space usage statistics (default: 30 days)")
         .option("--json", "Output as JSON")
         .action(async (days, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const usage = await client.space(spaceId).usage.get(parseInteger(days ?? "30", "days", { min: 1 }));
@@ -737,14 +734,14 @@ function registerLabels(spacesCmd) {
     const labelsCmd = spacesCmd
         .command("labels")
         .description("Manage labels")
-        .hook("preAction", () => { resolveSpace(spacesCmd); });
+        .hook("preAction", async () => { await resolveSpace(spacesCmd); });
     labelsCmd
         .command("ls")
         .alias("list")
         .description("List labels")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).labels.list();
@@ -764,7 +761,7 @@ function registerLabels(spacesCmd) {
         .description("Create a label")
         .option("--json", "Output as JSON")
         .action(async (labelRef, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).labels.create(labelRef);
@@ -784,7 +781,7 @@ function registerLabels(spacesCmd) {
         .option("--rank <n>", "Sort rank")
         .option("--json", "Output as JSON")
         .action(async (labelRef, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).labels.update(labelRef, {
@@ -805,7 +802,7 @@ function registerLabels(spacesCmd) {
         .alias("delete")
         .description("Delete a label")
         .action(async (labelRef) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).labels.delete(labelRef);
@@ -820,7 +817,7 @@ function registerLabels(spacesCmd) {
         .description("Reorder labels")
         .option("--json", "Output as JSON")
         .action(async (labelRefs, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).labels.reorder(labelRefs);
@@ -839,7 +836,7 @@ function registerLabels(spacesCmd) {
         .option("--cursor <cursor>", "Page cursor")
         .option("--json", "Output as JSON")
         .action(async (labelRef, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).labels.listItems(labelRef, {
@@ -864,7 +861,7 @@ function registerLabels(spacesCmd) {
         .description("Attach a label")
         .option("--json", "Output as JSON")
         .action(async (labelRef, resourceType, resourceRef, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).labels.attach(labelRef, { resourceType: parseLabelResourceType(resourceType), resourceRef });
@@ -880,7 +877,7 @@ function registerLabels(spacesCmd) {
         .command("detach <labelRef> <resourceType> <resourceRef>")
         .description("Detach a label")
         .action(async (labelRef, resourceType, resourceRef) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).labels.detach(labelRef, { resourceType: parseLabelResourceType(resourceType), resourceRef });
@@ -897,7 +894,7 @@ function registerLabels(spacesCmd) {
         .option("--remove <refs>", "Comma-separated label refs to remove")
         .option("--json", "Output as JSON")
         .action(async (resourceType, resourceRef, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).labels.patchResourceLabels(parseLabelResourceType(resourceType), resourceRef, {
@@ -918,7 +915,7 @@ function registerLabels(spacesCmd) {
         .option("--labels <refs>", "Comma-separated label refs")
         .option("--json", "Output as JSON")
         .action(async (resourceType, resourceRef, labelRefs, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const refs = [...parseLabelRefs(opts.labels), ...labelRefs];
@@ -936,14 +933,14 @@ function registerMods(spacesCmd) {
     const modsCmd = spacesCmd
         .command("mods")
         .description("Manage space mods")
-        .hook("preAction", () => { resolveSpace(spacesCmd); });
+        .hook("preAction", async () => { await resolveSpace(spacesCmd); });
     modsCmd
         .command("ls")
         .alias("list")
         .description("List mods")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).mods.list();
@@ -969,7 +966,7 @@ function registerMods(spacesCmd) {
         .option("--json", "Output as JSON")
         .action(async (modSpaceId, opts) => {
         await confirmRestart(opts);
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).mods.create({ modSpaceId, name: opts.name, mountSlug: opts.slug });
@@ -988,7 +985,7 @@ function registerMods(spacesCmd) {
         .option("--json", "Output as JSON")
         .action(async (modId, opts) => {
         await confirmRestart(opts);
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).mods.update(modId, { enabled: true });
@@ -1007,7 +1004,7 @@ function registerMods(spacesCmd) {
         .option("--json", "Output as JSON")
         .action(async (modId, opts) => {
         await confirmRestart(opts);
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).mods.update(modId, { enabled: false });
@@ -1027,7 +1024,7 @@ function registerMods(spacesCmd) {
         .option("--json", "Output as JSON")
         .action(async (modId, opts) => {
         await confirmRestart(opts);
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).mods.remove(modId);
@@ -1111,14 +1108,14 @@ function registerFiles(spacesCmd) {
     const filesCmd = spacesCmd
         .command("files")
         .description("File operations")
-        .hook("preAction", () => { resolveSpace(spacesCmd); });
+        .hook("preAction", async () => { await resolveSpace(spacesCmd); });
     filesCmd
         .command("ls [path]")
         .alias("list")
         .description("List directory tree")
         .option("--json", "Output as JSON")
         .action(async (path, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const tree = await client.space(spaceId).files.list(path ?? "");
@@ -1143,7 +1140,7 @@ function registerFiles(spacesCmd) {
         .command("cat <path>")
         .description("Read file content")
         .action(async (path) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const file = await client.space(spaceId).files.read(path);
@@ -1173,7 +1170,7 @@ function registerFiles(spacesCmd) {
         }
         if (!content)
             return error("No content provided", "Use -c or pipe via stdin");
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).files.write({
@@ -1197,7 +1194,7 @@ function registerFiles(spacesCmd) {
         .command("mkdir <path>")
         .description("Create a directory")
         .action(async (path) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).files.createDir(path);
@@ -1212,7 +1209,7 @@ function registerFiles(spacesCmd) {
         .description("Delete a file or directory")
         .option("-r, --recursive", "Delete recursively")
         .action(async (path, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).files.delete(path, opts.recursive ?? false);
@@ -1226,7 +1223,7 @@ function registerFiles(spacesCmd) {
         .command("mv <from> <to>")
         .description("Move or rename")
         .action(async (from, to) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).files.move({ fromPath: from, toPath: to });
@@ -1241,7 +1238,7 @@ function registerFiles(spacesCmd) {
         .description("Show pending workspace changes vs last checkpoint")
         .option("--json", "Output as JSON")
         .action(async (path, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             if (path) {
@@ -1272,14 +1269,14 @@ function registerSessions(spacesCmd) {
     const sessionsCmd = spacesCmd
         .command("sessions")
         .description("Browse sessions and turns")
-        .hook("preAction", () => { resolveSpace(spacesCmd); });
+        .hook("preAction", async () => { await resolveSpace(spacesCmd); });
     sessionsCmd
         .command("ls")
         .alias("list")
         .description("List sessions")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).sessions.list();
@@ -1306,7 +1303,7 @@ function registerSessions(spacesCmd) {
         .option("--label <ref>", "Attach a label, e.g. Bug or Area/Frontend", collectOption, [])
         .option("--json", "Output as JSON")
         .action(async (title, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).sessions.create({
@@ -1330,7 +1327,7 @@ function registerSessions(spacesCmd) {
         .description("Session details")
         .option("--json", "Output as JSON")
         .action(async (id, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).session(id).get();
@@ -1352,7 +1349,7 @@ function registerSessions(spacesCmd) {
         .command("rename <id> <name>")
         .description("Rename a session")
         .action(async (id, name) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).session(id).rename(name);
@@ -1368,7 +1365,7 @@ function registerSessions(spacesCmd) {
         .description("Stream realtime session events")
         .option("--json", "Output as JSON")
         .action(async (id, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         const session = client.space(spaceId).session(id);
         process.stdout.write("  Listening for events...\n\n");
@@ -1423,7 +1420,7 @@ function registerTurns(sessionsCmd) {
         .option("--limit <n>", "Page size", "30")
         .option("--json", "Output as JSON")
         .action(async (sessionId, opts) => {
-        const spaceId = resolveSpace(sessionsCmd);
+        const spaceId = await resolveSpace(sessionsCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).session(sessionId).turns.listPaginated({
@@ -1455,7 +1452,7 @@ function registerTurns(sessionsCmd) {
         .description("Show turn details")
         .option("--json", "Output as JSON")
         .action(async (sessionId, turnId, opts) => {
-        const spaceId = resolveSpace(sessionsCmd);
+        const spaceId = await resolveSpace(sessionsCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).session(sessionId).turns.get(turnId);
@@ -1484,7 +1481,7 @@ function registerTurns(sessionsCmd) {
         .description("Run a queued follow-up now")
         .option("--json", "Output as JSON")
         .action(async (sessionId, turnId, opts) => {
-        const spaceId = resolveSpace(sessionsCmd);
+        const spaceId = await resolveSpace(sessionsCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).session(sessionId).steerTurn(turnId);
@@ -1501,7 +1498,7 @@ function registerTurns(sessionsCmd) {
         .description("Cancel a queued follow-up")
         .option("--json", "Output as JSON")
         .action(async (sessionId, turnId, opts) => {
-        const spaceId = resolveSpace(sessionsCmd);
+        const spaceId = await resolveSpace(sessionsCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).session(sessionId).cancelTurn(turnId);
@@ -1520,7 +1517,7 @@ function registerTurns(sessionsCmd) {
         .option("--limit <n>", "Page size", "100")
         .option("--json", "Output as JSON")
         .action(async (sessionId, opts) => {
-        const spaceId = resolveSpace(sessionsCmd);
+        const spaceId = await resolveSpace(sessionsCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).session(sessionId).turns.index({
@@ -1554,7 +1551,7 @@ function registerTurns(sessionsCmd) {
         .option("--after <n>", "Turns after anchor", "20")
         .option("--json", "Output as JSON")
         .action(async (sessionId, opts) => {
-        const spaceId = resolveSpace(sessionsCmd);
+        const spaceId = await resolveSpace(sessionsCmd);
         if (!opts.sequence && !opts.turn)
             return error("Missing anchor", "Use --sequence <n> or --turn <id>");
         const client = createClient();
@@ -1647,14 +1644,14 @@ function registerMembers(spacesCmd) {
     const memCmd = spacesCmd
         .command("members")
         .description("Member management")
-        .hook("preAction", () => { resolveSpace(spacesCmd); });
+        .hook("preAction", async () => { await resolveSpace(spacesCmd); });
     memCmd
         .command("ls")
         .alias("list")
         .description("List space members")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).members.list();
@@ -1678,7 +1675,7 @@ function registerMembers(spacesCmd) {
         .command("update <userId> <role>")
         .description("Change member role (host | builder | guest)")
         .action(async (userId, role) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).members.update(userId, parseChoice(role, "role", SPACE_ROLES));
@@ -1692,7 +1689,7 @@ function registerMembers(spacesCmd) {
         .command("remove <userId>")
         .description("Remove a member")
         .action(async (userId) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).members.remove(userId);
@@ -1708,13 +1705,13 @@ function registerAccess(spacesCmd) {
     const accCmd = spacesCmd
         .command("access")
         .description("Access control")
-        .hook("preAction", () => { resolveSpace(spacesCmd); });
+        .hook("preAction", async () => { await resolveSpace(spacesCmd); });
     accCmd
         .command("get")
         .description("Get access policy")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const policy = await client.space(spaceId).access.get();
@@ -1736,7 +1733,7 @@ function registerAccess(spacesCmd) {
         .option("--anonymous <role>", "Role for anonymous users (host|builder|guest|null)")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const policy = await client.space(spaceId).access.set({
@@ -1761,7 +1758,7 @@ function registerCheckpoints(spacesCmd) {
     const cpCmd = spacesCmd
         .command("checkpoints")
         .description("Checkpoint management")
-        .hook("preAction", () => { resolveSpace(spacesCmd); });
+        .hook("preAction", async () => { await resolveSpace(spacesCmd); });
     cpCmd
         .command("ls")
         .alias("list")
@@ -1770,7 +1767,7 @@ function registerCheckpoints(spacesCmd) {
         .option("--cursor <cursor>", "Pagination cursor")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).checkpoints.list({
@@ -1799,7 +1796,7 @@ function registerCheckpoints(spacesCmd) {
         .description("Checkpoint details")
         .option("--json", "Output as JSON")
         .action(async (id, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).checkpoints.get(id);
@@ -1822,7 +1819,7 @@ function registerCheckpoints(spacesCmd) {
         .description("Create a checkpoint")
         .option("--json", "Output as JSON")
         .action(async (description, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).checkpoints.create(description ?? null);
@@ -1839,7 +1836,7 @@ function registerCheckpoints(spacesCmd) {
         .description("List checkpoint tree")
         .option("--json", "Output as JSON")
         .action(async (checkpointId, path, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const tree = await client.space(spaceId).checkpoints(checkpointId).files.list(path ?? "");
@@ -1866,7 +1863,7 @@ function registerCheckpoints(spacesCmd) {
         .description("Show checkpoint file content")
         .option("--json", "Output as JSON")
         .action(async (checkpointId, path, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const file = await client.space(spaceId).checkpoints(checkpointId).files.read(path);
@@ -1888,7 +1885,7 @@ function registerCheckpoints(spacesCmd) {
         .option("--base <checkpointId>", "Compare against another checkpoint")
         .option("--json", "Output as JSON")
         .action(async (checkpointId, path, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             if (path) {

package/dist/env-proxy.d.ts

@@ -0,0 +1,5 @@
+export declare function proxyEnvPresent(env?: NodeJS.ProcessEnv): boolean;
+export declare function envProxyAlreadyEnabled(execArgv?: readonly string[], env?: NodeJS.ProcessEnv): boolean;
+export declare function supportsUseEnvProxy(version?: string): boolean;
+export declare function shouldRelaunchWithEnvProxy(execArgv?: readonly string[], env?: NodeJS.ProcessEnv, nodeVersion?: string): boolean;
+export declare const envProxyExecArgv: readonly ["--use-env-proxy"];

package/dist/env-proxy.js

@@ -0,0 +1,20 @@
+const PROXY_ENV_KEYS = ["http_proxy", "https_proxy", "HTTP_PROXY", "HTTPS_PROXY", "all_proxy", "ALL_PROXY"];
+const USE_ENV_PROXY_FLAG = "--use-env-proxy";
+export function proxyEnvPresent(env = process.env) {
+    return PROXY_ENV_KEYS.some((key) => Boolean(env[key]?.trim()));
+}
+export function envProxyAlreadyEnabled(execArgv = process.execArgv, env = process.env) {
+    if (execArgv.includes(USE_ENV_PROXY_FLAG) || env.NODE_USE_ENV_PROXY === "1")
+        return true;
+    return (env.NODE_OPTIONS ?? "").split(/\s+/).includes(USE_ENV_PROXY_FLAG);
+}
+export function supportsUseEnvProxy(version = process.versions.node) {
+    const [major = 0, minor = 0] = version.split(".").map((part) => Number.parseInt(part, 10));
+    if (!Number.isFinite(major) || !Number.isFinite(minor))
+        return false;
+    return major >= 24 || (major === 22 && minor >= 21);
+}
+export function shouldRelaunchWithEnvProxy(execArgv = process.execArgv, env = process.env, nodeVersion = process.versions.node) {
+    return supportsUseEnvProxy(nodeVersion) && proxyEnvPresent(env) && !envProxyAlreadyEnabled(execArgv, env);
+}
+export const envProxyExecArgv = [USE_ENV_PROXY_FLAG];

package/dist/help-path.d.ts

@@ -0,0 +1,18 @@
+import type { Command } from "commander";
+export type HelpResolution = {
+    kind: "passthrough";
+} | {
+    kind: "help";
+    command: Command;
+} | {
+    kind: "run-help";
+} | {
+    kind: "unknown";
+    token: string;
+    tryCommand?: string;
+    suggestion?: string;
+};
+export declare function resolveHelpPath(program: Command, argv: string[]): HelpResolution;
+export declare function formatUnknownCommandError(result: Extract<HelpResolution, {
+    kind: "unknown";
+}>): string;