jevctl 0.1.0 → 0.2.0

package/dist/cli.js

@@ -1,17 +1,77 @@
 #!/usr/bin/env node
 // jev: TypeSafe's Jev model at the command line.
 import { createRequire } from "node:module";
+import { styleText } from "node:util";
 import { Command } from "commander";
 import { registerAsk } from "./commands/ask.js";
+import { registerAuth } from "./commands/auth.js";
+import { registerBatch } from "./commands/batch.js";
+import { registerClassify } from "./commands/classify.js";
+import { registerCompact } from "./commands/compact.js";
 import { registerConfig } from "./commands/config.js";
+import { registerExtract } from "./commands/extract.js";
 import { registerFind } from "./commands/find.js";
+import { registerMatch } from "./commands/match.js";
 import { registerModels } from "./commands/models.js";
+import { registerRerank } from "./commands/rerank.js";
+import { registerRoute } from "./commands/route.js";
 import { registerScreen } from "./commands/screen.js";
 import { registerVerify } from "./commands/verify.js";
 import { buildContext } from "./context.js";
 import { CliError, describeError, EXIT } from "./errors.js";
 const require = createRequire(import.meta.url);
 const { version, description } = require("../package.json");
+/** One-line summaries and groups for the top-level command list. Full descriptions live on each command. */
+const COMMANDS = {
+    verify: { group: "Judgments", summary: "Check claims against evidence; verdict + probabilities per claim" },
+    screen: {
+        group: "Judgments",
+        summary: "Flag prompt injection, filler, and irrelevance before an agent reads text",
+    },
+    classify: { group: "Judgments", summary: "Assign one, several, or hierarchical labels with confidence" },
+    extract: {
+        group: "Judgments",
+        summary: "Pull typed values out of text (regex candidates, Jev picks, code normalizes)",
+    },
+    match: {
+        group: "Judgments",
+        summary: "Decide if record pairs are the same thing: same, different, or unclear",
+    },
+    route: {
+        group: "Judgments",
+        summary: "Pick a handler for a request and fill its arguments from closed sets",
+    },
+    ask: { group: "Judgments", summary: "Ask raw yes/no, choice, or score questions about any state" },
+    find: { group: "Ranking", summary: "Rank up to 250 candidates against a plain-language query" },
+    rerank: { group: "Ranking", summary: "Score each candidate's relevance independently and sort" },
+    compact: {
+        group: "Pipelines",
+        summary: "Shrink an agent transcript by dropping stale tool calls, verbatim otherwise",
+    },
+    batch: { group: "Pipelines", summary: "Run a command over many rows with a concurrency pool; emits JSONL" },
+    models: { group: "Account", summary: "List the models available to your account" },
+    auth: { group: "Account", summary: "Store, inspect, or remove API keys (keychain or 0600 file)" },
+    config: { group: "Account", summary: "Show or edit the jev configuration file" },
+};
+const HELP_FOOTER = `
+Examples:
+  jev verify "Helmets are optional for adults" --evidence @ordinance.txt
+  curl -s https://example.com | jev screen --purpose "extract pricing" --fail-on block,review
+  jev classify "The invoice total is wrong" --labels billing,bug,feature --json
+  jev find "how do I rotate API keys" --files docs/*.md -k 3
+  jev batch classify -i @tickets.txt -- --labels billing,technical,sales
+
+Exit codes:
+  0  success
+  1  usage, configuration, input, or transport error
+  2  a --fail-on judgment condition matched (e.g. a contradicted claim)
+
+Credentials (first found wins unless --provider is set; environment first, then the jev auth login store):
+  TYPESAFE_API_KEY                                https://console.typesafe.ai/settings/keys
+  OPENROUTER_API_KEY (sk-or-...)                  OpenRouter Decisions API
+  CLOUDFLARE_API_TOKEN + CLOUDFLARE_ACCOUNT_ID    Cloudflare Workers AI
+
+Website: https://jevcli.vectorz.app   Docs: https://docs.typesafe.ai   Per-command help: jev <command> --help`;
 export function createProgram() {
     const program = new Command();
     program
@@ -20,26 +80,28 @@ export function createProgram() {
         .version(version, "-V, --version", "print the version")
         .showHelpAfterError("(run with --help for usage)")
         .showSuggestionAfterError()
+        .configureHelp({
+        helpWidth: Math.min(process.stdout.columns || 100, 110),
+        styleTitle: (s) => styleText("bold", s),
+        styleCommandText: (s) => styleText("cyan", s),
+        styleSubcommandText: (s) => styleText("cyan", s),
+        styleOptionText: (s) => styleText("green", s),
+        styleArgumentText: (s) => styleText("yellow", s),
+    })
+        .optionsGroup("Output:")
         .option("--json", "print results as JSON (same as --format json)")
-        .option("--format <fmt>", "output format: text or json")
+        .option("--md", "Markdown output (same as --format md)")
+        .option("--format <fmt>", "text, json, jsonl, csv, tsv, or md")
+        .option("--pluck <path>", "print one value from the JSON result, e.g. label or results[].verdict")
+        .option("-q, --quiet", "omit the usage/model footer in text output")
+        .option("--no-color", "disable colored output")
+        .optionsGroup("Model and transport:")
         .option("-m, --model <name>", "Jev model, e.g. jev-latest or jev-1.13.0")
         .option("-P, --provider <name>", "auto, typesafe, openrouter, or cloudflare")
         .option("--timeout <ms>", "per-request timeout in milliseconds")
-        .option("--no-color", "disable colored output")
-        .option("-q, --quiet", "omit the usage/model footer in text output")
         .option("--dry-run", "print the request that would be sent and exit without calling the API")
-        .addHelpText("after", `
-Exit codes:
-  0  success
-  1  usage, configuration, input, or transport error
-  2  a --fail-on judgment condition matched (e.g. a contradicted claim)
-
-Credentials (first found wins unless --provider is set):
-  TYPESAFE_API_KEY                                https://console.typesafe.ai/settings/keys
-  OPENROUTER_API_KEY (sk-or-...)                  OpenRouter Decisions API
-  CLOUDFLARE_API_TOKEN + CLOUDFLARE_ACCOUNT_ID    Cloudflare Workers AI
-
-Docs: https://docs.typesafe.ai`);
+        .optionsGroup("Options:")
+        .addHelpText("after", HELP_FOOTER);
     const run = async (fn, cmd) => {
         const flags = cmd.optsWithGlobals();
         const ctx = buildContext(flags);
@@ -47,12 +109,39 @@ Docs: https://docs.typesafe.ai`);
         if (code !== EXIT.OK)
             process.exitCode = code;
     };
+    // Registration order is the order shown in --help.
     registerVerify(program, run);
     registerScreen(program, run);
-    registerFind(program, run);
+    registerClassify(program, run);
+    registerExtract(program, run);
+    registerMatch(program, run);
+    registerRoute(program, run);
     registerAsk(program, run);
+    registerFind(program, run);
+    registerRerank(program, run);
+    registerCompact(program, run);
+    registerBatch(program, run);
     registerModels(program, run);
+    registerAuth(program, run);
     registerConfig(program, run);
+    for (const cmd of program.commands) {
+        const meta = COMMANDS[cmd.name()];
+        if (!meta)
+            throw new Error(`jev: no help metadata for command "${cmd.name()}"`);
+        cmd.summary(meta.summary).helpGroup(`${meta.group}:`);
+    }
+    program
+        .helpCommand(false)
+        .command("help [command]")
+        .summary("Show help for a command")
+        .description("Show help for a command, e.g. jev help verify. Same as jev <command> --help.")
+        .helpGroup("Account:")
+        .action((name) => {
+        const target = name ? program.commands.find((c) => c.name() === name) : program;
+        if (!target)
+            throw new CliError(`unknown command '${name}' (run jev --help for the list)`, EXIT.ERROR);
+        target.outputHelp();
+    });
     return program;
 }
 export async function main(argv = process.argv) {

package/dist/cli.js.map

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

package/dist/commands/ask.d.ts

@@ -1,6 +1,8 @@
 import type { Command } from "commander";
 import type { CommandContext } from "../context.js";
 import { type AskOutput, type RawQuestions } from "../core/ask.js";
+import type { BatchItemRunner } from "../core/batch.js";
+import { type View } from "../output.js";
 export interface AskFlags {
     questions?: string;
     noul?: string[];
@@ -11,5 +13,7 @@ export interface AskFlags {
 export declare function resolveState(positional: string | undefined, flags: AskFlags): unknown;
 export declare function resolveQuestions(flags: AskFlags): RawQuestions;
 export declare function askAction(positional: string | undefined, flags: AskFlags, ctx: CommandContext): Promise<number>;
-export declare function renderAsk(out: AskOutput, ctx: CommandContext): string;
+export declare function renderAsk(out: AskOutput, ctx: CommandContext): View;
 export declare function registerAsk(program: Command, run: (fn: (ctx: CommandContext) => Promise<number>, cmd: Command) => Promise<void>): void;
+/** Batch: each row is the state; questions are shared. Rows with a "state" field send it as-is. */
+export declare function prepareAskBatch(flags: AskFlags, ctx: CommandContext): BatchItemRunner;

package/dist/commands/ask.js

@@ -1,7 +1,7 @@
 import { parseQuestions, questionsFromFlags, runAsk, } from "../core/ask.js";
 import { CliError, EXIT } from "../errors.js";
 import { parseJson, readInput, readStdin } from "../input.js";
-import { emit, formatProbability, paint, usageLine } from "../output.js";
+import { emit, formatProbability, paint } from "../output.js";
 export function resolveState(positional, flags) {
     let raw;
     if (positional !== undefined)
@@ -34,7 +34,7 @@ export async function askAction(positional, flags, ctx) {
     const state = resolveState(positional, flags);
     const questions = resolveQuestions(flags);
     if (ctx.dryRun) {
-        emit({ ...ctx.output, format: "json" }, { model: ctx.config.model, state, questions }, () => "");
+        emit({ ...ctx.output, format: "json" }, { model: ctx.config.model, state, questions }, () => ({}));
         return EXIT.OK;
     }
     const output = await runAsk(ctx.ask(), { state, questions });
@@ -43,32 +43,36 @@ export async function askAction(positional, flags, ctx) {
 }
 export function renderAsk(out, ctx) {
     const c = ctx.output.color;
-    const lines = [];
+    const head = [];
+    const kv = [];
     for (const [id, answer] of Object.entries(out.answers)) {
+        // biome-ignore lint/suspicious/noExplicitAny: answer payloads are the SDK's loosely typed union
         const a = answer;
         if (a?.type === "noul") {
-            lines.push(`${paint(c, "bold", id)}: ${formatProbability(a.noul)}`);
+            head.push(`${paint(c, "bold", id)}: ${formatProbability(a.noul)}`);
+            kv.push([id, formatProbability(a.noul)]);
         }
         else if (a?.type === "choice") {
             const dist = Object.entries(a.probabilities ?? {})
                 .sort(([, x], [, y]) => y - x)
                 .map(([k, v]) => `${k} ${formatProbability(v)}`)
                 .join(", ");
-            lines.push(`${paint(c, "bold", id)}: ${paint(c, "green", String(a.choice))}  conf ${formatProbability(a.confidence)}  [${dist}]`);
+            head.push(`${paint(c, "bold", id)}: ${paint(c, "green", String(a.choice))}  conf ${formatProbability(a.confidence)}  [${dist}]`);
+            kv.push([id, `${a.choice} (conf ${formatProbability(a.confidence)})`]);
         }
         else if (a?.type === "score") {
             const levels = Object.entries(a.probabilities ?? {})
                 .map(([k, v]) => `${k} ${formatProbability(v)}`)
                 .join(", ");
-            lines.push(`${paint(c, "bold", id)}: ${paint(c, "green", Number(a.score).toFixed(2))}  conf ${formatProbability(a.confidence)}  [${levels}]`);
+            head.push(`${paint(c, "bold", id)}: ${paint(c, "green", Number(a.score).toFixed(2))}  conf ${formatProbability(a.confidence)}  [${levels}]`);
+            kv.push([id, `${Number(a.score).toFixed(2)} (conf ${formatProbability(a.confidence)})`]);
         }
         else {
-            lines.push(`${paint(c, "bold", id)}: ${JSON.stringify(answer)}`);
+            head.push(`${paint(c, "bold", id)}: ${JSON.stringify(answer)}`);
+            kv.push([id, JSON.stringify(answer)]);
         }
     }
-    if (!ctx.output.quiet)
-        lines.push(paint(c, "dim", usageLine(out.usage, out.model, out.provider)));
-    return lines.join("\n");
+    return { head, kv, usage: { usage: out.usage, model: out.model, provider: out.provider } };
 }
 export function registerAsk(program, run) {
     program
@@ -93,4 +97,17 @@ Examples:
 function collect(value, previous) {
     return [...previous, value];
 }
+/** Batch: each row is the state; questions are shared. Rows with a "state" field send it as-is. */
+export function prepareAskBatch(flags, ctx) {
+    const questions = resolveQuestions(flags);
+    return async (row) => {
+        const state = row.state !== undefined && typeof row.state !== "string"
+            ? row.state
+            : flags.stateJson
+                ? parseJson(row.text, `row ${row.id} state`)
+                : row.text;
+        const output = await runAsk(ctx.ask(), { state, questions });
+        return { output, failed: false };
+    };
+}
 //# sourceMappingURL=ask.js.map

package/dist/commands/ask.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask.js","sourceRoot":"","sources":["../../src/commands/ask.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,cAAc,EACd,kBAAkB,EAElB,MAAM,GACP,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAUzE,MAAM,UAAU,YAAY,CAAC,UAA8B,EAAE,KAAe;IAC1E,IAAI,GAAW,CAAC;IAChB,IAAI,UAAU,KAAK,SAAS;QAAE,GAAG,GAAG,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;SAC9D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK;QAAE,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;;QACnD,MAAM,IAAI,QAAQ,CAAC,2DAA2D,CAAC,CAAC;IACrF,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAe;IAC9C,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3G,IAAI,KAAK,CAAC,SAAS,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,QAAQ,CAAC,6EAA6E,CAAC,CAAC;IACpG,CAAC;IACD,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,SAAS;YACjB,OAAO,cAAc,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;QACzF,IAAI,SAAS;YAAE,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,QAAQ;YAAE,MAAM,GAAG,CAAC;QACvC,MAAM,IAAI,QAAQ,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,IAAI,QAAQ,CAChB,wFAAwF,CACzF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,UAA8B,EAC9B,KAAe,EACf,GAAmB;IAEnB,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAE1C,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACjG,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7D,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAc,EAAE,GAAmB;IAC3D,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,MAAM,CAAC,GAAG,MAA6B,CAAC;QACxC,IAAI,CAAC,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;aAAM,IAAI,CAAC,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC;iBAC/C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAE,CAAY,GAAI,CAAY,CAAC;iBACrD,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,CAAW,CAAC,EAAE,CAAC;iBACzD,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,KAAK,CAAC,IAAI,CACR,GAAG,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,iBAAiB,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,IAAI,GAAG,CACtH,CAAC;QACJ,CAAC;aAAM,IAAI,CAAC,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC;iBACjD,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,CAAW,CAAC,EAAE,CAAC;iBACzD,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,KAAK,CAAC,IAAI,CACR,GAAG,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,iBAAiB,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,MAAM,GAAG,CAClI,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAClG,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,OAAgB,EAChB,GAAkF;IAElF,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CACV,8FAA8F,CAC/F;SACA,QAAQ,CAAC,SAAS,EAAE,oDAAoD,CAAC;SACzE,MAAM,CAAC,cAAc,EAAE,wDAAwD,CAAC;SAChF,MAAM,CAAC,uBAAuB,EAAE,iEAAiE,CAAC;SAClG,MAAM,CAAC,0BAA0B,EAAE,8BAA8B,EAAE,OAAO,EAAE,EAAE,CAAC;SAC/E,MAAM,CACL,uCAAuC,EACvC,6CAA6C,EAC7C,OAAO,EACP,EAAE,CACH;SACA,MAAM,CAAC,wCAAwC,EAAE,sCAAsC,EAAE,OAAO,EAAE,EAAE,CAAC;SACrG,WAAW,CACV,OAAO,EACP;;;;;uEAKiE,CAClE;SACA,MAAM,CAAC,KAAK,EAAE,KAAyB,EAAE,KAAe,EAAE,GAAY,EAAE,EAAE;QACzE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,OAAO,CAAC,KAAa,EAAE,QAAkB;IAChD,OAAO,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"ask.js","sourceRoot":"","sources":["../../src/commands/ask.ts"],"names":[],"mappings":"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"}

package/dist/commands/auth.d.ts

@@ -0,0 +1,14 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../context.js";
+import { type CredentialProvider } from "../credentials.js";
+/** Prompt for a secret with echo off. Falls back to reading one line from a pipe. */
+export declare function promptSecret(prompt: string): Promise<string>;
+export declare function validateKey(provider: CredentialProvider, key: string): void;
+export declare function authLogin(providerName: string | undefined, flags: {
+    keyStdin?: boolean;
+}, ctx: CommandContext, env?: NodeJS.ProcessEnv): Promise<number>;
+export declare function authStatus(ctx: CommandContext, env?: NodeJS.ProcessEnv): number;
+export declare function authLogout(providerName: string | undefined, flags: {
+    all?: boolean;
+}, ctx: CommandContext, env?: NodeJS.ProcessEnv): number;
+export declare function registerAuth(program: Command, run: (fn: (ctx: CommandContext) => Promise<number>, cmd: Command) => Promise<void>): void;

package/dist/commands/auth.js

@@ -0,0 +1,134 @@
+import { createInterface } from "node:readline";
+import { Writable } from "node:stream";
+import { CREDENTIAL_PROVIDERS, ENV_VAR, resolveCredentials, resolveStore, } from "../credentials.js";
+import { CliError, EXIT } from "../errors.js";
+import { readStdin } from "../input.js";
+import { emit, paint } from "../output.js";
+import { mask } from "./config.js";
+function providerArg(raw) {
+    const p = (raw ?? "typesafe").toLowerCase();
+    if (!CREDENTIAL_PROVIDERS.includes(p)) {
+        throw new CliError(`Unknown provider "${raw}". Allowed: ${CREDENTIAL_PROVIDERS.join(", ")}.`);
+    }
+    return p;
+}
+/** Prompt for a secret with echo off. Falls back to reading one line from a pipe. */
+export async function promptSecret(prompt) {
+    if (!process.stdin.isTTY)
+        return readStdin("API key").split(/\r?\n/)[0]?.trim() ?? "";
+    const muted = new Writable({
+        write(_chunk, _enc, cb) {
+            cb();
+        },
+    });
+    const rl = createInterface({ input: process.stdin, output: muted, terminal: true });
+    process.stderr.write(prompt);
+    return new Promise((resolve) => {
+        rl.question("", (answer) => {
+            rl.close();
+            process.stderr.write("\n");
+            resolve(answer.trim());
+        });
+    });
+}
+export function validateKey(provider, key) {
+    if (!key)
+        throw new CliError("No key entered.");
+    if (/\s/.test(key))
+        throw new CliError("The key contains whitespace; paste it without spaces or line breaks.");
+    if (provider === "openrouter" && !key.startsWith("sk-or-"))
+        throw new CliError("OpenRouter keys start with sk-or-.");
+}
+export async function authLogin(providerName, flags, ctx, env = process.env) {
+    const provider = providerArg(providerName);
+    const store = resolveStore(env);
+    const key = flags.keyStdin
+        ? (readStdin("API key").split(/\r?\n/)[0]?.trim() ?? "")
+        : await promptSecret(`Paste your ${provider} API key (input hidden): `);
+    validateKey(provider, key);
+    store.set(provider, key);
+    const note = env[ENV_VAR[provider]]
+        ? ` Note: ${ENV_VAR[provider]} is set in this shell and will take precedence until you unset it.`
+        : "";
+    emit(ctx.output, { command: "auth", action: "login", provider, store: store.kind, location: store.location }, () => ({ head: [`Stored the ${provider} key in ${store.location}.${note}`] }));
+    return EXIT.OK;
+}
+export function authStatus(ctx, env = process.env) {
+    const store = resolveStore(env);
+    const rows = resolveCredentials(env, store).map((c) => {
+        const value = c.source === "env" ? env[ENV_VAR[c.provider]] : c.value;
+        return { provider: c.provider, env_var: ENV_VAR[c.provider], source: c.source, key: mask(value) };
+    });
+    const payload = {
+        command: "auth",
+        action: "status",
+        store: store.kind,
+        location: store.location,
+        credentials: rows,
+    };
+    emit(ctx.output, payload, () => {
+        const c = ctx.output.color;
+        return {
+            table: {
+                columns: ["Provider", "Source", "Key"],
+                rows: rows.map(({ provider, source, key: masked }) => [
+                    provider,
+                    source === "none" ? paint(c, "dim", "none") : source,
+                    masked ?? paint(c, "dim", "-"),
+                ]),
+            },
+            tail: [paint(c, "dim", `store: ${store.location}`)],
+        };
+    });
+    return rows.some((r) => r.source !== "none") ? EXIT.OK : EXIT.ERROR;
+}
+export function authLogout(providerName, flags, ctx, env = process.env) {
+    const store = resolveStore(env);
+    const providers = flags.all ? [...CREDENTIAL_PROVIDERS] : [providerArg(providerName)];
+    const removed = providers.filter((p) => store.delete(p));
+    emit(ctx.output, { command: "auth", action: "logout", removed, store: store.kind }, () => ({
+        head: [
+            removed.length
+                ? `Removed ${removed.join(", ")} from ${store.location}.`
+                : `Nothing stored for ${providers.join(", ")} in ${store.location}.`,
+        ],
+    }));
+    return EXIT.OK;
+}
+export function registerAuth(program, run) {
+    const auth = program
+        .command("auth")
+        .description("Store the API key in the OS keychain (or a 0600 file) instead of exporting it.");
+    auth
+        .command("login")
+        .description("Prompt for a key (hidden input) and store it. Reads one line from stdin when piped or with --key-stdin.")
+        .argument("[provider]", "typesafe (default) or openrouter")
+        .option("--key-stdin", "read the key from stdin (for scripts and password managers)")
+        .addHelpText("after", `
+Examples:
+  jev auth login
+  op read "op://Private/TypeSafe/credential" | jev auth login --key-stdin
+  jev auth login openrouter
+
+Where it goes: macOS Keychain (service "jevctl"), Linux Secret Service via secret-tool, otherwise
+~/.config/jev/credentials.json with mode 0600. Force one with JEV_CREDENTIAL_STORE=file|keychain.
+Resolution order at run time: environment variable, then the store. JEV_NO_STORED_CREDENTIALS=1 disables the store.`)
+        .action(async (provider, flags, cmd) => {
+        await run((ctx) => authLogin(provider, flags, ctx), cmd);
+    });
+    auth
+        .command("status", { isDefault: true })
+        .description("Show where each provider's key comes from (env, keychain, file, none), masked.")
+        .action(async (_flags, cmd) => {
+        await run(async (ctx) => authStatus(ctx, process.env), cmd);
+    });
+    auth
+        .command("logout")
+        .description("Remove a stored key.")
+        .argument("[provider]", "typesafe (default) or openrouter")
+        .option("--all", "remove every stored key")
+        .action(async (provider, flags, cmd) => {
+        await run(async (ctx) => authLogout(provider, flags, ctx), cmd);
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

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

package/dist/commands/batch.d.ts

@@ -0,0 +1,28 @@
+import { Command } from "commander";
+import type { CommandContext } from "../context.js";
+import { type BatchItemRunner } from "../core/batch.js";
+type Register = (program: Command, run: (fn: (ctx: CommandContext) => Promise<number>, cmd: Command) => Promise<void>) => void;
+type Prepare = (flags: any, ctx: CommandContext) => BatchItemRunner;
+/** Commands that accept one text input per row. */
+export declare const BATCHABLE: Record<string, {
+    register: Register;
+    prepare: Prepare;
+    rowIs: string;
+}>;
+export interface BatchFlags {
+    input?: string;
+    output?: string;
+    concurrency?: string;
+    failFast?: boolean;
+}
+/**
+ * Parse the sub-command's own flags by running its commander definition in capture mode.
+ * Commands with a required positional (find, rerank) get a placeholder so parsing succeeds;
+ * any other positional means the user passed a text argument that each row should supply.
+ */
+export declare function captureSubFlags(command: string, argv: string[]): Promise<Record<string, unknown>>;
+export declare function batchAction(command: string, subArgs: string[], flags: BatchFlags, ctx: CommandContext): Promise<number>;
+/** One-cell summary of a sub-command result, for csv/tsv/md batch tables. */
+export declare function summarizeResult(result: unknown): string;
+export declare function registerBatch(program: Command, run: (fn: (ctx: CommandContext) => Promise<number>, cmd: Command) => Promise<void>): void;
+export {};