blitzreels 0.1.4 → 0.1.5

package/README.md

@@ -16,7 +16,6 @@ After the first real publish:
 ```bash
 npx blitzreels version
 npx blitzreels doctor
-npx blitzreels prime
 npx blitzreels agent-context --json
 npx blitzreels auth login
 ```
@@ -35,8 +34,9 @@ blitzreels auth set-key --api-key br_live_...
 blitzreels auth whoami
 ```
 
-`auth login` opens BlitzReels in your browser, asks you to approve a one-time
-CLI code, then stores the generated API key in macOS Keychain when available or
+`auth login` opens BlitzReels in your browser, shows the one-time CLI code, and
+waits for you to click `Connect CLI`. After confirmation, it stores the
+generated API key in macOS Keychain when available or
 `~/.blitzreels/config.json` as a fallback. Use `--no-browser` on remote shells
 and open the printed URL manually.
 
@@ -103,13 +103,15 @@ blitzreels text update --project-id PROJECT_ID --content-item-id CONTENT_ITEM_ID
 blitzreels text remove --project-id PROJECT_ID --content-item-id CONTENT_ITEM_ID
 
 blitzreels audio search --query "ambient riser" --license cc0 --json
-blitzreels audio import --provider openverse --external-id AUDIO_ID --project-id PROJECT_ID --at 0 --duration 12 --volume 0.5
-blitzreels audio add --project-id PROJECT_ID --asset-id ASSET_ID --at 0 --volume 0.6
+blitzreels audio import --provider openverse --external-id AUDIO_ID --project-id PROJECT_ID --at 0 --duration 12 --volume 0.03
+blitzreels audio add --project-id PROJECT_ID --asset-id ASSET_ID --at 0 --volume 0.03
 
 blitzreels captions words list --project-id PROJECT_ID --match-text "Supabase" --json
 blitzreels captions words text --project-id PROJECT_ID --word-id WORD_ID --text "Supabase"
 blitzreels captions words batch-text --project-id PROJECT_ID --updates-json '[{"word_id":"WORD_ID","new_text":"Supabase"}]'
+blitzreels captions words batch-text --project-id PROJECT_ID --updates-file caption-updates.json
 blitzreels captions words style --project-id PROJECT_ID --word-id WORD_ID --font-family Pacifico --color "#17FFA6" --scale 1.45
+blitzreels captions words style --project-id PROJECT_ID --all --style-file caption-word-style.json
 blitzreels captions words emphasis --project-id PROJECT_ID --match-text "MCP" --emphasis true
 blitzreels captions words delete --project-id PROJECT_ID --word-id WORD_ID
 blitzreels captions words merge --project-id PROJECT_ID --word-ids WORD_ID_1,WORD_ID_2 --text "serveurs MCP"
@@ -121,11 +123,11 @@ blitzreels silence apply --project-id PROJECT_ID --timeline-item-id TIMELINE_ITE
 blitzreels mistakes plan --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --json
 blitzreels mistakes apply --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --confirm-preview
 
-blitzreels captions themes list --json
-blitzreels captions theme set --project-id PROJECT_ID --theme-id THEME_ID
-blitzreels captions theme set-default --theme-id THEME_ID
+blitzreels captions looks list --json
+blitzreels captions look set --project-id PROJECT_ID --look-id editor-premium-lime
+blitzreels captions style update --project-id PROJECT_ID --look-id paper-karaoke --text-stroke-enabled false
 
-blitzreels exports start --project-id PROJECT_ID
+blitzreels exports start --project-id PROJECT_ID --cover-frame-seconds 1
 blitzreels exports wait --export-id EXPORT_ID
 blitzreels exports download --export-id EXPORT_ID --output ./short.mp4
 
@@ -135,28 +137,23 @@ blitzreels api spec
 
 Use `--json` for script and AI-agent workflows.
 Use `--fields id,name` with `--json` to trim large responses.
+Export status responses include `thumbnail_url`, `thumbnail.frame_seconds`, `thumbnail.rationale`, and first-pass `platform_metadata` suggestions for YouTube, TikTok, and Instagram.
 
-## Agent Workflows
+## Machine-Readable Contract
 
 ```bash
-blitzreels prime
-blitzreels prime --command "media attach"
 blitzreels agent-context --json
 blitzreels agent-context --command "media attach" --json
 blitzreels schema --command "captions words style" --json
 blitzreels media attach --project-id PROJECT_ID --asset-id ASSET_ID --at 6 --dry-run
 ```
 
-`prime` prints plain-language instructions that coding agents should read before
-editing BlitzReels projects. It is inspired by agent-first CLIs like Beans'
-`prime` command. `llms` is an alias.
-
 `agent-context` is the machine-readable command contract for agents. It includes
 command metadata, typed flags, examples, read/write markers, destructive markers,
 and known error categories.
 
-When the CLI detects an agent environment, command help also points agents to
-`prime` and `agent-context` for the focused command.
+Agent workflow strategy lives in BlitzReels skills and docs, not in CLI command
+metadata or normal command output.
 
 `--dry-run` is available on mutating commands and prints the API request that
 would be made without making the write request. Destructive dry-runs still require

package/dist/agent-context.d.ts

@@ -0,0 +1,43 @@
+import { type CliExitCode } from "./cli-errors.js";
+import type { CommandSpec, FlagSpec } from "./command-metadata.js";
+export type AgentContext = {
+    schema_version: "1";
+    cli: {
+        name: "blitzreels";
+        version: string;
+        default_base_url: string;
+        exit_codes: Array<{
+            code: CliExitCode;
+            meaning: string;
+            retryable: boolean;
+        }>;
+    };
+    commands: Array<{
+        operation_id: string;
+        command: string;
+        category: string;
+        description: string;
+        usage: string;
+        mutates: boolean;
+        destructive: boolean;
+        requires_auth: boolean;
+        dry_run_supported: boolean;
+        flags: readonly FlagSpec[];
+        examples: readonly string[];
+        errors: Array<{
+            code: string;
+            description: string;
+            exit_code: CliExitCode;
+            retryable: boolean;
+        }>;
+    }>;
+};
+export declare function buildAgentContext({ commandFilter, commandSpecs, surfaceName, }: {
+    commandFilter: string | undefined;
+    commandSpecs: CommandSpec[];
+    surfaceName?: string;
+}): AgentContext;
+export declare function buildAgentContextLines({ value, }: {
+    value: AgentContext;
+}): string[];
+//# sourceMappingURL=agent-context.d.ts.map

package/dist/agent-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context.d.ts","sourceRoot":"","sources":["../src/agent-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAiB,MAAM,iBAAiB,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAQnE,MAAM,MAAM,YAAY,GAAG;IACzB,cAAc,EAAE,GAAG,CAAC;IACpB,GAAG,EAAE;QACH,IAAI,EAAE,YAAY,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,KAAK,CAAC;YAChB,IAAI,EAAE,WAAW,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,EAAE,OAAO,CAAC;SACpB,CAAC,CAAC;KACJ,CAAC;IACF,QAAQ,EAAE,KAAK,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,OAAO,CAAC;QACrB,aAAa,EAAE,OAAO,CAAC;QACvB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;QAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;QAC5B,MAAM,EAAE,KAAK,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,SAAS,EAAE,WAAW,CAAC;YACvB,SAAS,EAAE,OAAO,CAAC;SACpB,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,EAChC,aAAa,EACb,YAAY,EACZ,WAA6B,GAC9B,EAAE;IACD,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,YAAY,CA0Cf;AAED,wBAAgB,sBAAsB,CAAC,EACrC,KAAK,GACN,EAAE;IACD,KAAK,EAAE,YAAY,CAAC;CACrB,GAAG,MAAM,EAAE,CAKX"}

package/dist/agent-context.js

@@ -0,0 +1,170 @@
+import { CliUsageError } from "./cli-errors.js";
+import { CLI_VERSION, DEFAULT_BASE_URL } from "./cli-runtime.js";
+import { commandLabel, commandsEqual, flagsForCommand, suggestCommandSpecs, } from "./command-metadata.js";
+export function buildAgentContext({ commandFilter, commandSpecs, surfaceName = "agent-context", }) {
+    const commands = commandFilter
+        ? commandSpecs.filter((spec) => commandsEqual(spec.command, splitCommandFilter({ value: commandFilter })))
+        : commandSpecs;
+    if (commandFilter && commands.length === 0) {
+        throw new CliUsageError({
+            code: "unknown_command",
+            message: `Unknown command for ${surfaceName}: ${commandFilter}`,
+            suggestions: suggestCommandSpecs({
+                command: splitCommandFilter({ value: commandFilter }),
+                specs: commandSpecs,
+            }).map((spec) => commandLabel({ command: spec.command })),
+        });
+    }
+    return {
+        schema_version: "1",
+        cli: {
+            name: "blitzreels",
+            version: CLI_VERSION,
+            default_base_url: DEFAULT_BASE_URL,
+            exit_codes: buildCliExitCodeContract(),
+        },
+        commands: commands.map((spec) => ({
+            operation_id: operationIdForCommand({ command: spec.command }),
+            command: commandLabel({ command: spec.command }),
+            category: spec.command[0] ?? "unknown",
+            description: spec.description,
+            usage: spec.usage,
+            mutates: spec.mutates,
+            destructive: spec.destructive,
+            requires_auth: spec.requiresAuth,
+            dry_run_supported: spec.dryRunSupported,
+            flags: flagsForCommand({ spec }),
+            examples: spec.examples,
+            errors: buildCommandErrors({ spec }),
+        })),
+    };
+}
+export function buildAgentContextLines({ value, }) {
+    return value.commands.map((command) => `${command.command} ${command.mutates ? "write" : "read"}${command.destructive ? " destructive" : ""}${command.dry_run_supported ? " dry-run" : ""} - ${command.description}`);
+}
+function splitCommandFilter({ value }) {
+    return value
+        .trim()
+        .split(/\s+/)
+        .filter((part) => part.length > 0);
+}
+function buildCommandErrors({ spec }) {
+    const errors = [
+        {
+            code: "unknown_command",
+            description: "Command is not registered.",
+            exit_code: 2,
+            retryable: false,
+        },
+        {
+            code: "unknown_flag",
+            description: "Flag is not accepted by command.",
+            exit_code: 2,
+            retryable: false,
+        },
+        {
+            code: "missing_required_flag",
+            description: "A required flag was not provided.",
+            exit_code: 2,
+            retryable: false,
+        },
+        {
+            code: "invalid_flag_value",
+            description: "A flag value could not be parsed.",
+            exit_code: 2,
+            retryable: false,
+        },
+        {
+            code: "cli_error",
+            description: "Input or local execution failed.",
+            exit_code: 1,
+            retryable: false,
+        },
+    ];
+    if (spec.requiresAuth) {
+        errors.push({
+            code: "api_error",
+            description: "BlitzReels API returned a non-2xx response.",
+            exit_code: 1,
+            retryable: false,
+        });
+        errors.push({
+            code: "auth_error",
+            description: "Authentication or permission failed.",
+            exit_code: 3,
+            retryable: false,
+        });
+        errors.push({
+            code: "not_found",
+            description: "Requested BlitzReels resource was not found.",
+            exit_code: 4,
+            retryable: false,
+        });
+        errors.push({
+            code: "conflict",
+            description: "Requested operation conflicted with current project state.",
+            exit_code: 5,
+            retryable: false,
+        });
+        errors.push({
+            code: "rate_limited",
+            description: "Request was rate limited.",
+            exit_code: 6,
+            retryable: true,
+        });
+        errors.push({
+            code: "server_error",
+            description: "BlitzReels API returned a transient server error.",
+            exit_code: 7,
+            retryable: true,
+        });
+    }
+    if (spec.mutates && !spec.dryRunSupported) {
+        errors.push({
+            code: "unsupported_dry_run",
+            description: "--dry-run was used on a command that cannot preview.",
+            exit_code: 2,
+            retryable: false,
+        });
+    }
+    if (spec.destructive) {
+        errors.push({
+            code: "missing_confirmation",
+            description: "Required destructive confirmation flag was not provided.",
+            exit_code: 2,
+            retryable: false,
+        });
+    }
+    return errors;
+}
+function operationIdForCommand({ command }) {
+    const [first = "unknown", ...rest] = command;
+    return [
+        first,
+        ...rest.map((part) => part.replace(/-([a-z0-9])/g, (_match, value) => value.toUpperCase())),
+    ].join(".");
+}
+function buildCliExitCodeContract() {
+    return [
+        { code: 1, meaning: "Local or generic API failure.", retryable: false },
+        {
+            code: 2,
+            meaning: "Usage error: command, flag, or input is invalid.",
+            retryable: false,
+        },
+        {
+            code: 3,
+            meaning: "Authentication or permission failure.",
+            retryable: false,
+        },
+        { code: 4, meaning: "Requested resource was not found.", retryable: false },
+        {
+            code: 5,
+            meaning: "Conflict with current server state.",
+            retryable: false,
+        },
+        { code: 6, meaning: "Rate limited; retry after backoff.", retryable: true },
+        { code: 7, meaning: "Transient server/provider failure.", retryable: true },
+    ];
+}
+//# sourceMappingURL=agent-context.js.map

package/dist/agent-context.js.map

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

package/dist/cli-command-routing.d.ts

@@ -0,0 +1,27 @@
+import { CliUsageError } from "./cli-errors.js";
+import type { ParsedArgs } from "./cli-types.js";
+import { type CommandSpec } from "./command-metadata.js";
+export declare function parseArgs({ argv }: {
+    argv: string[];
+}): ParsedArgs;
+export declare function validateParsedArgs({ parsed }: {
+    parsed: ParsedArgs;
+}): void;
+export declare function validateSafeInputs({ parsed }: {
+    parsed: ParsedArgs;
+}): void;
+export declare function findCommandSpec({ command, }: {
+    command: string[];
+}): CommandSpec | undefined;
+export declare function findGroupCommandSpecs({ command, }: {
+    command: string[];
+}): CommandSpec[];
+export declare function printCommandOrGroupHelpOrThrow({ command, }: {
+    command: string[];
+}): void;
+export declare function printHelp(): void;
+export declare function buildUnknownCommandError({ command, }: {
+    command: string[];
+}): CliUsageError;
+export declare function usageForCurrentCommand(): string | undefined;
+//# sourceMappingURL=cli-command-routing.d.ts.map

package/dist/cli-command-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-routing.d.ts","sourceRoot":"","sources":["../src/cli-command-routing.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAS,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,KAAK,WAAW,EAOjB,MAAM,uBAAuB,CAAC;AAG/B,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,UAAU,CAiClE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAwB3E;AAED,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAgB3E;AAED,wBAAgB,eAAe,CAAC,EAC9B,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,WAAW,GAAG,SAAS,CAE1B;AAED,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,WAAW,EAAE,CAOhB;AAED,wBAAgB,8BAA8B,CAAC,EAC7C,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,IAAI,CAYP;AAED,wBAAgB,SAAS,IAAI,IAAI,CAWhC;AAED,wBAAgB,wBAAwB,CAAC,EACvC,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,aAAa,CAQhB;AAED,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAG3D"}

package/dist/cli-command-routing.js

@@ -0,0 +1,236 @@
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { CliUsageError } from "./cli-errors.js";
+import { commandLabel, commandsEqual, flagsForCommand, GLOBAL_FLAGS, suggestCommandSpecs, suggestValues, } from "./command-metadata.js";
+import { COMMAND_SPECS } from "./command-registry.js";
+export function parseArgs({ argv }) {
+    const command = [];
+    const flags = {};
+    for (let index = 0; index < argv.length; index++) {
+        const value = argv[index];
+        if (value === undefined) {
+            continue;
+        }
+        if (!value.startsWith("--")) {
+            command.push(value);
+            continue;
+        }
+        const [rawKey, inlineValue] = value.slice(2).split("=", 2);
+        const key = rawKey ?? "";
+        if (inlineValue !== undefined) {
+            flags[key] = inlineValue;
+            continue;
+        }
+        const next = argv[index + 1];
+        if (next !== undefined && !next.startsWith("--")) {
+            flags[key] = next;
+            index++;
+            continue;
+        }
+        flags[key] = true;
+    }
+    return { command, flags };
+}
+export function validateParsedArgs({ parsed }) {
+    const spec = findCommandSpec({ command: parsed.command });
+    if (!spec) {
+        throw buildUnknownCommandError({ command: parsed.command });
+    }
+    const allowedFlags = new Set([
+        ...GLOBAL_FLAGS,
+        ...spec.flags.map((flag) => flag.name),
+    ]);
+    for (const flag of Object.keys(parsed.flags)) {
+        if (!allowedFlags.has(flag)) {
+            throw buildUnknownFlagError({ spec, flag });
+        }
+    }
+    if (getBooleanFlag({ flags: parsed.flags, name: "dry-run" })) {
+        if (!spec.dryRunSupported) {
+            throw new CliUsageError({
+                code: "unsupported_dry_run",
+                message: "--dry-run is not supported for this command.",
+                usage: spec.usage,
+            });
+        }
+    }
+}
+export function validateSafeInputs({ parsed }) {
+    for (const [name, value] of Object.entries(parsed.flags)) {
+        if (typeof value !== "string") {
+            continue;
+        }
+        rejectControlChars({ name, value });
+        if (isIdLikeFlag({ name })) {
+            rejectUnsafeId({ name, value });
+        }
+        if (name === "url") {
+            rejectUnsafeUrl({ name, value });
+        }
+        if (name === "output") {
+            rejectUnsafeOutputPath({ value });
+        }
+    }
+}
+export function findCommandSpec({ command, }) {
+    return COMMAND_SPECS.find((spec) => commandsEqual(spec.command, command));
+}
+export function findGroupCommandSpecs({ command, }) {
+    if (command.length === 0) {
+        return [];
+    }
+    return COMMAND_SPECS.filter((spec) => commandsEqual(spec.command.slice(0, command.length), command));
+}
+export function printCommandOrGroupHelpOrThrow({ command, }) {
+    const spec = findCommandSpec({ command });
+    if (spec) {
+        printCommandHelp({ spec });
+        return;
+    }
+    const groupSpecs = findGroupCommandSpecs({ command });
+    if (groupSpecs.length > 0) {
+        printGroupHelp({ command, specs: groupSpecs });
+        return;
+    }
+    throw buildUnknownCommandError({ command });
+}
+export function printHelp() {
+    console.log(`blitzreels
+
+Usage:
+${COMMAND_SPECS.map((spec) => `  ${spec.usage}`).join("\n")}
+
+Global flags:
+  --api-key KEY
+  --base-url URL
+  --json
+`);
+}
+export function buildUnknownCommandError({ command, }) {
+    const suggestions = suggestCommands({ command }).map((spec) => spec.usage);
+    return new CliUsageError({
+        code: "unknown_command",
+        message: `Unknown command: ${commandLabel({ command })}`,
+        suggestions,
+        usage: suggestions[0],
+    });
+}
+export function usageForCurrentCommand() {
+    const parsed = parseArgs({ argv: process.argv.slice(2) });
+    return findCommandSpec({ command: parsed.command })?.usage;
+}
+function printCommandHelp({ spec }) {
+    const flags = flagsForCommand({ spec });
+    console.log(`Usage:
+  ${spec.usage}
+
+Description:
+  ${spec.description}
+
+Flags:
+${flags
+        .map((flag) => {
+        const required = flag.required ? " required" : "";
+        const values = flag.enum ? ` (${flag.enum.join("|")})` : "";
+        const defaultValue = flag.default === undefined ? "" : ` default=${String(flag.default)}`;
+        return `  --${flag.name} ${flag.type}${required}${values}${defaultValue}  ${flag.description}`;
+    })
+        .join("\n")}
+
+Examples:
+${spec.examples.map((example) => `  ${example}`).join("\n")}
+`);
+}
+function printGroupHelp({ command, specs, }) {
+    const label = commandLabel({ command });
+    console.log(`blitzreels ${label}
+
+Available commands:
+${specs.map((spec) => `  ${spec.usage}`).join("\n")}
+
+Examples:
+${specs
+        .slice(0, 4)
+        .flatMap((spec) => spec.examples.slice(0, 1))
+        .map((example) => `  ${example}`)
+        .join("\n")}
+`);
+}
+function buildUnknownFlagError({ spec, flag, }) {
+    const flags = [
+        ...new Set([
+            ...spec.flags.map((candidate) => candidate.name),
+            ...GLOBAL_FLAGS,
+        ]),
+    ];
+    const suggestions = suggestValues({ value: flag, candidates: flags }).map((candidate) => `--${candidate}`);
+    return new CliUsageError({
+        code: "unknown_flag",
+        message: `Unknown flag --${flag} for \`${commandLabel({ command: spec.command })}\`.`,
+        suggestions,
+        usage: spec.usage,
+    });
+}
+function suggestCommands({ command }) {
+    return suggestCommandSpecs({ command, specs: COMMAND_SPECS });
+}
+function getBooleanFlag({ flags, name, }) {
+    return flags[name] === true || flags[name] === "true";
+}
+function rejectControlChars({ name, value, }) {
+    if (Array.from(value).some((character) => {
+        const code = character.charCodeAt(0);
+        return code < 32 || code === 127;
+    })) {
+        throw new CliUsageError({
+            code: "unsafe_input",
+            message: `--${name} contains control characters.`,
+        });
+    }
+}
+function isIdLikeFlag({ name }) {
+    return name === "id" || name.endsWith("-id") || name.endsWith("-ids");
+}
+function rejectUnsafeId({ name, value, }) {
+    if (/[?#%]/.test(value)) {
+        throw new CliUsageError({
+            code: "unsafe_input",
+            message: `--${name} must be an ID, not a URL or encoded path.`,
+        });
+    }
+}
+function rejectUnsafeUrl({ name, value, }) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new CliUsageError({
+            code: "unsafe_input",
+            message: `--${name} must be a valid URL.`,
+        });
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new CliUsageError({
+            code: "unsafe_input",
+            message: `--${name} must use http or https.`,
+        });
+    }
+    if (url.username || url.password) {
+        throw new CliUsageError({
+            code: "unsafe_input",
+            message: `--${name} must not include embedded credentials.`,
+        });
+    }
+}
+function rejectUnsafeOutputPath({ value }) {
+    const outputPath = resolve(value);
+    const sensitiveDirs = [join(homedir(), ".ssh"), join(homedir(), ".gnupg")];
+    if (sensitiveDirs.some((dir) => outputPath.startsWith(`${dir}/`) || outputPath === dir)) {
+        throw new CliUsageError({
+            code: "unsafe_input",
+            message: "--output cannot write into sensitive home directories.",
+        });
+    }
+}
+//# sourceMappingURL=cli-command-routing.js.map

package/dist/cli-command-routing.js.map

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

package/dist/cli-errors.d.ts

@@ -0,0 +1,29 @@
+export type CliExitCode = 1 | 2 | 3 | 4 | 5 | 6 | 7;
+export type CliErrorContract = {
+    code: string;
+    exitCode: CliExitCode;
+    retryable: boolean;
+};
+export declare class CliUsageError extends Error {
+    code: string;
+    suggestions: string[];
+    usage: string | undefined;
+    constructor({ code, message, suggestions, usage, }: {
+        code: string;
+        message: string;
+        suggestions?: string[];
+        usage?: string;
+    });
+}
+export declare class CliOperationError extends Error {
+    code: string;
+    exitCode: CliExitCode;
+    retryable: boolean;
+    constructor({ code, exitCode, message, retryable, }: {
+        code: string;
+        exitCode: CliExitCode;
+        message: string;
+        retryable: boolean;
+    });
+}
+//# sourceMappingURL=cli-errors.d.ts.map

package/dist/cli-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-errors.d.ts","sourceRoot":"","sources":["../src/cli-errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,qBAAa,aAAc,SAAQ,KAAK;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEd,EACV,IAAI,EACJ,OAAO,EACP,WAAgB,EAChB,KAAK,GACN,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;CAOF;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;gBAEP,EACV,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,SAAS,GACV,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,WAAW,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB;CAOF"}

package/dist/cli-errors.js

@@ -0,0 +1,25 @@
+export class CliUsageError extends Error {
+    code;
+    suggestions;
+    usage;
+    constructor({ code, message, suggestions = [], usage, }) {
+        super(message);
+        this.name = "CliUsageError";
+        this.code = code;
+        this.suggestions = suggestions;
+        this.usage = usage;
+    }
+}
+export class CliOperationError extends Error {
+    code;
+    exitCode;
+    retryable;
+    constructor({ code, exitCode, message, retryable, }) {
+        super(message);
+        this.name = "CliOperationError";
+        this.code = code;
+        this.exitCode = exitCode;
+        this.retryable = retryable;
+    }
+}
+//# sourceMappingURL=cli-errors.js.map

package/dist/cli-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-errors.js","sourceRoot":"","sources":["../src/cli-errors.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,IAAI,CAAS;IACb,WAAW,CAAW;IACtB,KAAK,CAAqB;IAE1B,YAAY,EACV,IAAI,EACJ,OAAO,EACP,WAAW,GAAG,EAAE,EAChB,KAAK,GAMN;QACC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,IAAI,CAAS;IACb,QAAQ,CAAc;IACtB,SAAS,CAAU;IAEnB,YAAY,EACV,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,SAAS,GAMV;QACC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF"}