@hypercli.com/cli 0.0.0-stage → 0.9.1

package/dist/commands/voice.js

@@ -0,0 +1,378 @@
+/**
+ * `hyper voice` — voice capability API.
+ *
+ *   hyper voice clone "hello" --file ref.wav clone a voice from reference audio over /ws/voice
+ *   hyper voice transcribe audio.wav         speech-to-text over /ws/voice/transcribe
+ *   hyper voice transcribe audio.wav --rest  one-shot STT (POST /voice/transcribe)
+ *
+ * Generation goes through the remote voice API. Audio is written with
+ * node:fs/promises; stdout stays machine-usable.
+ */
+import { readFile, stat, writeFile } from 'node:fs/promises';
+import { lookup } from 'node:dns/promises';
+import { isIP } from 'node:net';
+import { basename, resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { APIError } from '@hypercli.com/sdk';
+import { parseCommandArgs } from '../core/argv.js';
+import { CliError, UsageError } from '../core/errors.js';
+import { renderGroupHelp } from '../core/help.js';
+export const name = 'voice';
+export const summary = 'Reference voice cloning and transcription via the voice capability API.';
+// Named so error messages cite the right subcommand; `usage` composes these
+// so a positional index can never drift away from the subcommand handler.
+const USAGE_CLONE = 'hyper voice clone <text> (--file audio | --url audio-url) [--out file.mp3] [--rest] [--json]';
+const USAGE_TRANSCRIBE = 'hyper voice transcribe <audio-file> [--language en] [--out transcript.txt] [--rest] [--json]';
+export const usage = [USAGE_CLONE, USAGE_TRANSCRIBE];
+const MAX_REFERENCE_AUDIO_BYTES = 25 * 1024 * 1024;
+const REFERENCE_AUDIO_TIMEOUT_MS = 30_000;
+const CLONE_OPTIONS = {
+    file: { type: 'string' },
+    url: { type: 'string' },
+    out: { type: 'string' },
+    rest: { type: 'boolean', default: false },
+};
+const TRANSCRIBE_OPTIONS = {
+    language: { type: 'string' },
+    out: { type: 'string' },
+    rest: { type: 'boolean', default: false },
+};
+function describeError(err) {
+    if (err instanceof APIError)
+        return `${err.statusCode}: ${err.detail}`;
+    return err instanceof Error ? err.message : String(err);
+}
+/** File/stdout generation requests MP3 explicitly; SDK WebSockets default to PCM. */
+async function collectStream(chunks) {
+    const parts = [];
+    for await (const chunk of chunks) {
+        if (chunk.audio && chunk.audio.byteLength > 0)
+            parts.push(Buffer.from(chunk.audio));
+    }
+    return Buffer.concat(parts);
+}
+async function collectTranscript(events) {
+    let text = '';
+    for await (const event of events) {
+        if (event.type === 'transcript.final')
+            return event.text;
+        if (event.type === 'transcript.delta')
+            text += event.delta || event.text;
+    }
+    return text;
+}
+function validateReferenceUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new UsageError('voice clone --url must be a valid HTTPS URL');
+    }
+    if (parsed.protocol !== 'https:') {
+        throw new UsageError('voice clone --url only accepts HTTPS URLs');
+    }
+    const host = parsed.hostname.toLowerCase();
+    if (host === 'localhost' || host.endsWith('.localhost')) {
+        throw new UsageError('voice clone --url cannot target localhost');
+    }
+    if (isBlockedIpLiteral(host)) {
+        throw new UsageError('voice clone --url cannot target private, local, or reserved IP addresses');
+    }
+    return parsed;
+}
+function ipv4ToNumber(host) {
+    const parts = host.split('.').map((part) => Number(part));
+    if (parts.length !== 4 || parts.some((part) => !Number.isInteger(part) || part < 0 || part > 255))
+        return undefined;
+    return ((parts[0] << 24) >>> 0) + (parts[1] << 16) + (parts[2] << 8) + parts[3];
+}
+function ipv6ToBigInt(host) {
+    const value = host.replace(/^\[|\]$/g, '').toLowerCase();
+    if (!isIP(value))
+        return undefined;
+    if (value.includes('.'))
+        return undefined;
+    const halves = value.split('::');
+    if (halves.length > 2)
+        return undefined;
+    const left = halves[0] ? halves[0].split(':') : [];
+    const right = halves[1] ? halves[1].split(':') : [];
+    const fill = 8 - left.length - right.length;
+    if (fill < 0 || (halves.length === 1 && fill !== 0))
+        return undefined;
+    const groups = [...left, ...Array(fill).fill('0'), ...right];
+    return groups.reduce((acc, group) => (acc << 16n) + BigInt(parseInt(group || '0', 16)), 0n);
+}
+function inRange(value, base, bits) {
+    const mask = bits === 0 ? 0 : (0xffffffff << (32 - bits)) >>> 0;
+    return (value & mask) === (base & mask);
+}
+function inRange6(value, base, bits) {
+    const mask = ((1n << BigInt(bits)) - 1n) << BigInt(128 - bits);
+    return (value & mask) === (base & mask);
+}
+function isBlockedIpLiteral(host) {
+    const unbracketed = host.replace(/^\[|\]$/g, '');
+    const family = isIP(unbracketed);
+    if (family === 4) {
+        const value = ipv4ToNumber(unbracketed);
+        if (value === undefined)
+            return true;
+        return [
+            ['0.0.0.0', 8],
+            ['10.0.0.0', 8],
+            ['100.64.0.0', 10],
+            ['127.0.0.0', 8],
+            ['169.254.0.0', 16],
+            ['172.16.0.0', 12],
+            ['192.0.0.0', 24],
+            ['192.0.2.0', 24],
+            ['192.168.0.0', 16],
+            ['198.18.0.0', 15],
+            ['198.51.100.0', 24],
+            ['203.0.113.0', 24],
+            ['224.0.0.0', 4],
+            ['240.0.0.0', 4],
+        ].some(([base, bits]) => inRange(value, ipv4ToNumber(base), bits));
+    }
+    if (family === 6) {
+        const value = ipv6ToBigInt(unbracketed);
+        if (value === undefined)
+            return true;
+        return value === 0n || value === 1n || [
+            ['fc00::', 7],
+            ['fe80::', 10],
+            ['ff00::', 8],
+            ['2001:db8::', 32],
+        ].some(([base, bits]) => inRange6(value, ipv6ToBigInt(base), bits));
+    }
+    return false;
+}
+async function assertSafeResolvedHost(host) {
+    const unbracketed = host.replace(/^\[|\]$/g, '');
+    if (isIP(unbracketed))
+        return;
+    let addresses;
+    try {
+        addresses = await lookup(host, { all: true, verbatim: true });
+    }
+    catch {
+        return;
+    }
+    if (addresses.some((address) => isBlockedIpLiteral(address.address))) {
+        throw new UsageError('voice clone --url cannot resolve to private, local, or reserved IP addresses');
+    }
+}
+async function readUrlBytes(url) {
+    const parsed = validateReferenceUrl(url);
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), REFERENCE_AUDIO_TIMEOUT_MS);
+    let response;
+    let current = parsed;
+    try {
+        for (let redirects = 0; redirects <= 5; redirects += 1) {
+            await assertSafeResolvedHost(current.hostname);
+            response = await fetch(current.href, { signal: controller.signal, redirect: 'manual' });
+            if (![301, 302, 303, 307, 308].includes(response.status))
+                break;
+            const location = response.headers.get('location');
+            if (!location)
+                break;
+            current = validateReferenceUrl(new URL(location, current).href);
+        }
+        if (!response)
+            throw new CliError('failed to fetch reference audio');
+        if (!response.ok) {
+            throw new CliError(`failed to fetch reference audio: ${response.status} ${response.statusText}`);
+        }
+        const contentLength = response.headers.get('content-length');
+        const contentLengthBytes = contentLength ? Number(contentLength) : undefined;
+        if (contentLengthBytes !== undefined && (!Number.isFinite(contentLengthBytes) || contentLengthBytes > MAX_REFERENCE_AUDIO_BYTES)) {
+            throw new CliError(`reference audio exceeds ${MAX_REFERENCE_AUDIO_BYTES} bytes`);
+        }
+        const reader = response.body?.getReader();
+        if (!reader)
+            return Buffer.from(await response.arrayBuffer());
+        const chunks = [];
+        let total = 0;
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            total += value.byteLength;
+            if (total > MAX_REFERENCE_AUDIO_BYTES) {
+                throw new CliError(`reference audio exceeds ${MAX_REFERENCE_AUDIO_BYTES} bytes`);
+            }
+            chunks.push(Buffer.from(value));
+        }
+        return Buffer.concat(chunks, total);
+    }
+    catch (err) {
+        if (err instanceof CliError || err instanceof UsageError)
+            throw err;
+        throw new CliError(`failed to fetch reference audio: ${describeError(err)}`);
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+async function readReferenceFile(file) {
+    const info = await stat(file);
+    if (info.size > MAX_REFERENCE_AUDIO_BYTES) {
+        throw new CliError(`reference audio exceeds ${MAX_REFERENCE_AUDIO_BYTES} bytes`);
+    }
+    const bytes = await readFile(file);
+    if (bytes.byteLength > MAX_REFERENCE_AUDIO_BYTES) {
+        throw new CliError(`reference audio exceeds ${MAX_REFERENCE_AUDIO_BYTES} bytes`);
+    }
+    return bytes;
+}
+async function clone(ctx, args) {
+    const parsed = parseCommandArgs(args, CLONE_OPTIONS);
+    if (parsed.help) {
+        process.stdout.write(`${renderGroupHelp({ name, summary, usage, run })}\n`);
+        return;
+    }
+    const [text, ...rest] = parsed.positionals;
+    if (!text || rest.length > 0) {
+        throw new UsageError(`usage: ${USAGE_CLONE}`);
+    }
+    const fileArg = typeof parsed.values.file === 'string' ? parsed.values.file : undefined;
+    const urlArg = typeof parsed.values.url === 'string' ? parsed.values.url : undefined;
+    if ((fileArg ? 1 : 0) + (urlArg ? 1 : 0) !== 1) {
+        throw new UsageError('voice clone requires exactly one of --file or --url');
+    }
+    const outArg = typeof parsed.values.out === 'string' ? parsed.values.out : undefined;
+    if (!outArg && ctx.format === 'json') {
+        throw new UsageError('voice clone --json requires --out');
+    }
+    const source = fileArg ? resolve(fileArg) : urlArg;
+    const refAudio = fileArg ? await readReferenceFile(source) : await readUrlBytes(source);
+    const client = await ctx.client();
+    const stream = parsed.values.rest !== true;
+    let bytes;
+    try {
+        bytes = stream
+            ? await collectStream(client.voice.cloneStream({ text, refAudio, responseFormat: 'mp3' }))
+            : await client.voice.clone({ text, refAudio });
+    }
+    catch (err) {
+        throw new CliError(`clone failed: ${describeError(err)}`);
+    }
+    if (!outArg) {
+        process.stdout.write(Buffer.from(bytes));
+        return;
+    }
+    const outFile = resolve(outArg);
+    await writeFile(outFile, bytes);
+    ctx.output.info(`saved ${outFile} (${bytes.byteLength} bytes)`);
+    const record = { out: outFile, source, bytes: bytes.byteLength };
+    ctx.output.result(ctx.format === 'json' ? { ...record, text, stream, format: 'mp3' } : record, {
+        columns: ['OUT', 'SOURCE', 'BYTES'],
+        rows: [[outFile, source, String(bytes.byteLength)]],
+    });
+}
+async function transcribe(ctx, args) {
+    const parsed = parseCommandArgs(args, TRANSCRIBE_OPTIONS);
+    if (parsed.help) {
+        process.stdout.write(`${renderGroupHelp({ name, summary, usage, run })}\n`);
+        return;
+    }
+    const [audioFile, ...rest] = parsed.positionals;
+    if (!audioFile || rest.length > 0) {
+        throw new UsageError(`usage: ${USAGE_TRANSCRIBE}`);
+    }
+    const language = typeof parsed.values.language === 'string' ? parsed.values.language : undefined;
+    const useRest = parsed.values.rest === true;
+    const stream = !useRest;
+    const outArg = typeof parsed.values.out === 'string' ? parsed.values.out : undefined;
+    const file = resolve(audioFile);
+    const outFile = outArg ? resolve(outArg) : undefined;
+    const audio = await readFile(file);
+    const client = await ctx.client();
+    let text;
+    try {
+        if (stream) {
+            text = await collectTranscript(client.voice.transcribeStream({
+                audio,
+                language,
+            }));
+        }
+        else {
+            const result = await client.voice.transcribe({
+                audio,
+                filename: basename(file),
+                language,
+            });
+            text = result.text;
+        }
+    }
+    catch (err) {
+        throw new CliError(`transcribe failed: ${describeError(err)}`);
+    }
+    if (outFile) {
+        await writeFile(outFile, text, 'utf8');
+        ctx.output.info(`saved ${outFile} (${text.length} chars)`);
+    }
+    const record = { text, file, out: outFile, language, stream };
+    if (outFile) {
+        ctx.output.result(record, {
+            columns: ['FILE', 'OUT', 'CHARS'],
+            rows: [[file, outFile, String(text.length)]],
+        });
+    }
+    else {
+        ctx.output.result(record, text);
+    }
+}
+export async function run(ctx, args) {
+    // Non-strict pre-scan with the union of subcommand flags: --help routes to
+    // group help regardless of position, strict errors stay in the subcommand.
+    const pre = parseUniversalGroup(args);
+    if (pre.help || pre.positionals.length === 0) {
+        process.stdout.write(`${renderGroupHelp({ name, summary, usage, run })}\n`);
+        return;
+    }
+    const [sub] = pre.positionals;
+    // Hand the subcommand its own argv (original args minus the sub token)
+    // so flags survive strict re-parsing inside the subcommand. Splice at the
+    // index of the first positional TOKEN — never indexOf the word, which can
+    // hit an earlier flag value.
+    const subArgs = [...args];
+    subArgs.splice(pre.subIndex, 1);
+    switch (sub) {
+        case 'clone':
+            return clone(ctx, subArgs);
+        case 'transcribe':
+            return transcribe(ctx, subArgs);
+        default:
+            throw new UsageError(`unknown voice command '${sub}'\nusage: ${usage.join('\n       ')}`);
+    }
+}
+/** Loose scan over the union of all subcommand flags (never throws). */
+function parseUniversalGroup(args) {
+    const parsed = parseArgs({
+        args,
+        options: {
+            json: { type: 'boolean' },
+            output: { type: 'string', short: 'o' },
+            help: { type: 'boolean', short: 'h' },
+            out: { type: 'string' },
+            file: { type: 'string' },
+            url: { type: 'string' },
+            language: { type: 'string' },
+            rest: { type: 'boolean' },
+        },
+        strict: false,
+        allowPositionals: true,
+        tokens: true,
+    });
+    const subToken = (parsed.tokens ?? []).find((token) => token.kind === 'positional');
+    return {
+        help: parsed.values.help === true,
+        positionals: parsed.positionals,
+        subIndex: subToken?.index ?? -1,
+    };
+}
+//# sourceMappingURL=voice.js.map

package/dist/commands/voice.js.map

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

package/dist/commands/websearch-core.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Core for `hyper websearch`: Brave web search through the agents API proxy
+ * (Deployments.webSearch, py-cli parity).
+ *
+ * The group module parses argv, makes the call, and renders output here; the
+ * only caller-provided piece is which help listing --help prints, passed in
+ * as onHelp.
+ */
+import type { CommandContext } from '../core/types.js';
+export declare function runWebSearch(ctx: CommandContext, args: string[], onHelp: () => void): Promise<void>;

package/dist/commands/websearch-core.js

@@ -0,0 +1,56 @@
+/**
+ * Core for `hyper websearch`: Brave web search through the agents API proxy
+ * (Deployments.webSearch, py-cli parity).
+ *
+ * The group module parses argv, makes the call, and renders output here; the
+ * only caller-provided piece is which help listing --help prints, passed in
+ * as onHelp.
+ */
+import { APIError } from '@hypercli.com/sdk';
+import { parseCommandArgs } from '../core/argv.js';
+import { CliError, UsageError } from '../core/errors.js';
+function str(parsed, key) {
+    const value = parsed.values[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function describeFailure(err) {
+    if (err instanceof APIError)
+        return `HTTP ${err.statusCode}: ${err.detail}`;
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+export async function runWebSearch(ctx, args, onHelp) {
+    const parsed = parseCommandArgs(args, { count: { type: 'string', short: 'n' } });
+    if (parsed.help) {
+        onHelp();
+        return;
+    }
+    if (parsed.positionals.length === 0)
+        throw new UsageError('missing query');
+    const query = parsed.positionals.join(' ');
+    const countRaw = str(parsed, 'count');
+    let count = 5;
+    if (countRaw !== undefined) {
+        count = Number(countRaw);
+        if (!Number.isInteger(count) || count < 1 || count > 20) {
+            throw new UsageError(`--count must be an integer between 1 and 20 (got '${countRaw}')`);
+        }
+    }
+    const { deployments } = await ctx.client();
+    let payload;
+    try {
+        payload = await deployments.webSearch(query, { count });
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw new CliError(`web search failed: ${describeFailure(err)}`);
+    }
+    const results = Array.isArray(payload.web?.results) ? payload.web.results : [];
+    const rows = results
+        .filter((item) => item !== null && typeof item === 'object')
+        .map((item) => [String(item.title ?? ''), String(item.url ?? '')]);
+    ctx.output.result(payload, rows.length === 0 ? 'No results.' : { columns: ['TITLE', 'URL'], rows });
+}
+//# sourceMappingURL=websearch-core.js.map

package/dist/commands/websearch-core.js.map

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

package/dist/commands/websearch.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `hyper websearch` — top-level Brave web search through the agents API proxy.
+ *
+ *   hyper websearch <query...> [-n|--count N] [--json]
+ *
+ * The only web search surface; the implementation lives in
+ * src/commands/websearch-core.ts.
+ */
+import type { CommandContext } from '../core/types.js';
+export declare const name = "websearch";
+export declare const summary = "Web search through the agents API proxy.";
+export declare const usage: string[];
+export declare function run(ctx: CommandContext, args: string[]): Promise<void>;

package/dist/commands/websearch.js

@@ -0,0 +1,20 @@
+/**
+ * `hyper websearch` — top-level Brave web search through the agents API proxy.
+ *
+ *   hyper websearch <query...> [-n|--count N] [--json]
+ *
+ * The only web search surface; the implementation lives in
+ * src/commands/websearch-core.ts.
+ */
+import { renderGroupHelp } from '../core/help.js';
+import { runWebSearch } from './websearch-core.js';
+export const name = 'websearch';
+export const summary = 'Web search through the agents API proxy.';
+export const usage = ['hyper websearch <query...> [-n|--count N] [--json]'];
+function printHelp() {
+    process.stdout.write(`${renderGroupHelp({ name, summary, usage, run })}\n`);
+}
+export async function run(ctx, args) {
+    return runWebSearch(ctx, args, printHelp);
+}
+//# sourceMappingURL=websearch.js.map

package/dist/commands/websearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websearch.js","sourceRoot":"","sources":["../../src/commands/websearch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,CAAC,MAAM,IAAI,GAAG,WAAW,CAAC;AAChC,MAAM,CAAC,MAAM,OAAO,GAAG,0CAA0C,CAAC;AAClE,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,oDAAoD,CAAC,CAAC;AAE5E,SAAS,SAAS;IAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,GAAmB,EAAE,IAAc;IAC3D,OAAO,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAC5C,CAAC"}

package/dist/core/argv.d.ts

@@ -0,0 +1,51 @@
+/**
+ * argv parsing on node:util parseArgs. No commander/yargs/typer.
+ *
+ * Universal flags understood everywhere:
+ *   --json            machine output (single JSON.stringify on stdout)
+ *   --output, -o FMT  'table' (default) or 'json'
+ *   --help, -h        print help
+ *
+ * parseUniversal()  — non-strict top-level scan used by the entrypoint to
+ *                     find the group name and global flags without rejecting
+ *                     group-specific options.
+ * parseCommandArgs()— strict parse inside a command group; merges the
+ *                     universal options with group-specific ones and maps
+ *                     parse failures to UsageError (exit 2).
+ */
+import { type ParseArgsConfig } from 'node:util';
+import type { OutputFormat } from './output.js';
+type Options = NonNullable<ParseArgsConfig['options']>;
+export declare const UNIVERSAL_OPTIONS: Options;
+/**
+ * Parsed argv shape shared by parseUniversal() and parseCommandArgs(). The
+ * parsing behavior differs (non-strict vs strict) but the result shape is
+ * identical.
+ */
+export interface ParsedArgs {
+    values: Record<string, unknown>;
+    positionals: string[];
+    format: OutputFormat;
+    help: boolean;
+}
+/** Back-compat alias — same shape as ParsedArgs. */
+export type ParsedCommand = ParsedArgs;
+/** ParsedArgs plus the argv index of the first positional token — group
+    dispatchers splice at this index rather than textually searching for the
+    group/subcommand word, which can collide with an earlier flag value. */
+export interface ParsedUniversal extends ParsedArgs {
+    /** argv index of the first positional token, or -1 when there are none. */
+    firstPositionalIndex: number;
+}
+/** Resolve the output format from --json / --output. */
+export declare function resolveFormat(values: Record<string, unknown>): OutputFormat;
+/** Non-strict scan of full argv, except for retired public environment flags. */
+export declare function parseUniversal(argv: string[]): ParsedUniversal;
+/**
+ * Strict parse for inside a command group. Universal options are always
+ * allowed; pass only group-specific options. Bad flags -> UsageError.
+ */
+export declare function parseCommandArgs(args: string[], options?: Options, config?: {
+    allowPositionals?: boolean;
+}): ParsedCommand;
+export {};

package/dist/core/argv.js

@@ -0,0 +1,81 @@
+/**
+ * argv parsing on node:util parseArgs. No commander/yargs/typer.
+ *
+ * Universal flags understood everywhere:
+ *   --json            machine output (single JSON.stringify on stdout)
+ *   --output, -o FMT  'table' (default) or 'json'
+ *   --help, -h        print help
+ *
+ * parseUniversal()  — non-strict top-level scan used by the entrypoint to
+ *                     find the group name and global flags without rejecting
+ *                     group-specific options.
+ * parseCommandArgs()— strict parse inside a command group; merges the
+ *                     universal options with group-specific ones and maps
+ *                     parse failures to UsageError (exit 2).
+ */
+import { parseArgs } from 'node:util';
+import { UsageError } from './errors.js';
+export const UNIVERSAL_OPTIONS = {
+    json: { type: 'boolean', default: false },
+    output: { type: 'string', short: 'o' },
+    help: { type: 'boolean', short: 'h', default: false },
+};
+/** Resolve the output format from --json / --output. */
+export function resolveFormat(values) {
+    const output = typeof values.output === 'string' ? values.output : undefined;
+    if (values.json === true || output === 'json')
+        return 'json';
+    if (output !== undefined && output !== 'table') {
+        throw new UsageError(`unknown output format '${output}' (expected 'table' or 'json')`);
+    }
+    return 'table';
+}
+/** Non-strict scan of full argv, except for retired public environment flags. */
+export function parseUniversal(argv) {
+    const { values, positionals, tokens } = parseArgs({
+        args: argv,
+        options: UNIVERSAL_OPTIONS,
+        strict: false,
+        allowPositionals: true,
+        tokens: true,
+    });
+    for (const token of tokens ?? []) {
+        if (token.kind === 'option' && (token.name === 'dev' || token.name === 'prod')) {
+            throw new UsageError(`--${token.name} is not supported; set HYPER_API_BASE and/or HYPER_AGENTS_API_BASE instead`);
+        }
+    }
+    const firstPositional = (tokens ?? []).find((token) => token.kind === 'positional');
+    return {
+        values: values,
+        positionals,
+        format: resolveFormat(values),
+        help: values.help === true,
+        firstPositionalIndex: firstPositional?.index ?? -1,
+    };
+}
+/**
+ * Strict parse for inside a command group. Universal options are always
+ * allowed; pass only group-specific options. Bad flags -> UsageError.
+ */
+export function parseCommandArgs(args, options = {}, config = {}) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args,
+            options: { ...UNIVERSAL_OPTIONS, ...options },
+            allowPositionals: config.allowPositionals ?? true,
+            strict: true,
+        });
+    }
+    catch (err) {
+        throw new UsageError(err instanceof Error ? err.message : String(err));
+    }
+    const values = parsed.values;
+    return {
+        values,
+        positionals: parsed.positionals,
+        format: resolveFormat(values),
+        help: values.help === true,
+    };
+}
+//# sourceMappingURL=argv.js.map

package/dist/core/argv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argv.js","sourceRoot":"","sources":["../../src/core/argv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAwB,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC,MAAM,CAAC,MAAM,iBAAiB,GAAY;IACxC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;IACzC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;IACtC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;CACtD,CAAC;AAyBF,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,MAA+B;IAC3D,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IAC7D,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QAC/C,MAAM,IAAI,UAAU,CAAC,0BAA0B,MAAM,gCAAgC,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAChD,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,iBAAiB;QAC1B,MAAM,EAAE,KAAK;QACb,gBAAgB,EAAE,IAAI;QACtB,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IACH,KAAK,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;YAC/E,MAAM,IAAI,UAAU,CAAC,KAAK,KAAK,CAAC,IAAI,4EAA4E,CAAC,CAAC;QACpH,CAAC;IACH,CAAC;IACD,MAAM,eAAe,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;IACpF,OAAO;QACL,MAAM,EAAE,MAAiC;QACzC,WAAW;QACX,MAAM,EAAE,aAAa,CAAC,MAAiC,CAAC;QACxD,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI;QAC1B,oBAAoB,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC,CAAC;KACnD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAc,EACd,UAAmB,EAAE,EACrB,SAAyC,EAAE;IAE3C,IAAI,MAAoC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC;YACjB,IAAI;YACJ,OAAO,EAAE,EAAE,GAAG,iBAAiB,EAAE,GAAG,OAAO,EAAE;YAC7C,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,IAAI;YACjD,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAiC,CAAC;IACxD,OAAO;QACL,MAAM;QACN,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC;QAC7B,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI;KAC3B,CAAC;AACJ,CAAC"}