jevctl 0.1.0 → 0.2.0

package/dist/commands/batch.js

@@ -0,0 +1,221 @@
+import { createWriteStream, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { Command } from "commander";
+import { parseRows, runBatch } from "../core/batch.js";
+import { CliError, EXIT } from "../errors.js";
+import { readInput } from "../input.js";
+import { paint, pluck, renderDelimited, renderMarkdown, renderPluck } from "../output.js";
+import { prepareAskBatch, registerAsk } from "./ask.js";
+import { prepareClassifyBatch, registerClassify } from "./classify.js";
+import { prepareExtractBatch, registerExtract } from "./extract.js";
+import { prepareFindBatch, registerFind } from "./find.js";
+import { prepareRerankBatch, registerRerank } from "./rerank.js";
+import { prepareRouteBatch, registerRoute } from "./route.js";
+import { prepareScreenBatch, registerScreen } from "./screen.js";
+import { prepareVerifyBatch, registerVerify } from "./verify.js";
+/** Commands that accept one text input per row. */
+export const BATCHABLE = {
+    classify: { register: registerClassify, prepare: prepareClassifyBatch, rowIs: "the text to classify" },
+    screen: { register: registerScreen, prepare: prepareScreenBatch, rowIs: "the text to screen" },
+    extract: { register: registerExtract, prepare: prepareExtractBatch, rowIs: "the text to extract from" },
+    ask: { register: registerAsk, prepare: prepareAskBatch, rowIs: "the state" },
+    verify: {
+        register: registerVerify,
+        prepare: prepareVerifyBatch,
+        rowIs: "one claim (evidence is shared via -e)",
+    },
+    find: {
+        register: registerFind,
+        prepare: prepareFindBatch,
+        rowIs: "one query (candidates are shared via --files etc.)",
+    },
+    rerank: {
+        register: registerRerank,
+        prepare: prepareRerankBatch,
+        rowIs: "one query (candidates are shared via --files etc.)",
+    },
+    route: { register: registerRoute, prepare: prepareRouteBatch, rowIs: "the request to route" },
+};
+const PLACEHOLDER = "__jev_batch_row__";
+/**
+ * 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 async function captureSubFlags(command, argv) {
+    const entry = BATCHABLE[command];
+    if (!entry)
+        throw new CliError(`"${command}" cannot be batched. Batchable: ${Object.keys(BATCHABLE).join(", ")}.`);
+    let captured;
+    let positional = [];
+    const tmp = new Command().exitOverride().configureOutput({ writeErr: () => { }, writeOut: () => { } });
+    entry.register(tmp, async (_fn, cmd) => {
+        captured = cmd.opts();
+        positional = cmd.args;
+    });
+    const parse = (args) => tmp.parseAsync(["node", "jev", command, ...args]);
+    try {
+        await parse(argv);
+    }
+    catch (err) {
+        const message = err.message ?? "";
+        if (!/missing required argument/i.test(message)) {
+            throw new CliError(`Invalid ${command} flags: ${message.replace(/^error: /, "")}`);
+        }
+        try {
+            await parse([...argv, PLACEHOLDER]);
+        }
+        catch (err2) {
+            throw new CliError(`Invalid ${command} flags: ${(err2.message ?? "").replace(/^error: /, "")}`);
+        }
+    }
+    const leaked = positional.filter((p) => p !== PLACEHOLDER);
+    if (leaked.length > 0) {
+        throw new CliError(`Do not pass positional input to a batched ${command}; each row supplies ${entry.rowIs}.`);
+    }
+    return captured ?? {};
+}
+export async function batchAction(command, subArgs, flags, ctx) {
+    if (!flags.input)
+        throw new CliError("Provide --input <@file|-> with one row per line (plain text or JSONL).");
+    const subFlags = await captureSubFlags(command, subArgs);
+    const entry = BATCHABLE[command];
+    const item = entry.prepare(subFlags, ctx);
+    const concurrency = flags.concurrency === undefined ? ctx.config.batch.concurrency : Number(flags.concurrency);
+    if (!Number.isInteger(concurrency) || concurrency < 1 || concurrency > 64)
+        throw new CliError("--concurrency must be an integer from 1 to 64.");
+    let rows;
+    try {
+        rows = parseRows(readInput(flags.input, "batch input"));
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw new CliError(err.message);
+    }
+    if (ctx.dryRun) {
+        process.stdout.write(`${JSON.stringify({ command, rows: rows.length, concurrency, flags: subFlags }, null, 2)}\n`);
+        return EXIT.OK;
+    }
+    const out = flags.output ? openOutput(flags.output) : process.stdout;
+    const format = ctx.output.format;
+    const streaming = format === "text" || format === "jsonl";
+    const collected = [];
+    const write = (record) => {
+        if (ctx.output.pluck) {
+            out.write(`${renderPluck(pluck(record, ctx.output.pluck), format === "json" ? "jsonl" : format)}\n`);
+        }
+        else if (streaming) {
+            out.write(`${JSON.stringify(record)}\n`);
+        }
+        else
+            collected.push(record);
+    };
+    const stopOnError = Boolean(flags.failFast);
+    let aborted = false;
+    const guarded = async (row) => {
+        if (aborted)
+            throw new Error("skipped after earlier failure (--fail-fast)");
+        try {
+            return await item(row);
+        }
+        catch (err) {
+            if (stopOnError)
+                aborted = true;
+            throw err;
+        }
+    };
+    const { summary } = await runBatch(rows, guarded, { concurrency, onRecord: write });
+    if (!ctx.output.pluck && !streaming) {
+        if (format === "json")
+            out.write(`${JSON.stringify(collected, null, 2)}\n`);
+        else {
+            const view = {
+                table: {
+                    columns: ["id", "ok", "failed", "result"],
+                    rows: collected.map((r) => [
+                        r.id,
+                        String(r.ok),
+                        String(r.failed),
+                        r.ok ? summarizeResult(r.result) : `error: ${r.error}`,
+                    ]),
+                },
+            };
+            out.write(`${format === "md" ? renderMarkdown(view, { quiet: true }) : renderDelimited(view, format === "tsv" ? "\t" : ",")}\n`);
+        }
+    }
+    if (out !== process.stdout)
+        await new Promise((resolve) => out.end(resolve));
+    const c = ctx.output.color;
+    const line = `${summary.total} rows · ${summary.ok} ok · ${summary.errors} errors · ${summary.failed} matched fail-on · ${summary.input_tokens} in / ${summary.output_tokens} out tokens`;
+    if (!ctx.output.quiet || out === process.stdout)
+        process.stderr.write(`${paint(c, summary.errors ? "yellow" : "dim", line)}\n`);
+    if (summary.errors > 0)
+        return EXIT.ERROR;
+    return summary.failed > 0 ? EXIT.JUDGMENT : EXIT.OK;
+}
+/** One-cell summary of a sub-command result, for csv/tsv/md batch tables. */
+export function summarizeResult(result) {
+    // biome-ignore lint/suspicious/noExplicitAny: answer payloads are the SDK's loosely typed union
+    const r = (result ?? {});
+    if (typeof r.label === "string")
+        return r.label;
+    if (Array.isArray(r.applied))
+        return r.applied.join("; ");
+    if (Array.isArray(r.path))
+        return r.path.join(" > ");
+    if (r.handler !== undefined)
+        return r.handler ?? "none";
+    if (r.recommendation?.action)
+        return r.recommendation.action;
+    if (r.exists_verdict)
+        return `${r.exists_verdict}: ${(r.top ?? []).map((t) => t.id).join("; ")}`;
+    if (Array.isArray(r.kept))
+        return r.kept.join("; ");
+    if (Array.isArray(r.results) && r.results[0]?.verdict)
+        return r.results.map((x) => x.verdict).join("; ");
+    if (r.fields)
+        return Object.entries(r.fields)
+            .map(([k, v]) => `${k}=${v.value ?? ""}`)
+            .join("; ");
+    if (r.answers)
+        return Object.entries(r.answers)
+            .map(([k, v]) => {
+            const a = v;
+            return `${k}=${a.choice ?? a.noul ?? a.score ?? ""}`;
+        })
+            .join("; ");
+    return "";
+}
+function openOutput(ref) {
+    const path = ref.startsWith("@") ? ref.slice(1) : ref;
+    mkdirSync(dirname(path), { recursive: true });
+    return createWriteStream(path, { encoding: "utf8" });
+}
+export function registerBatch(program, run) {
+    program
+        .command("batch")
+        .description("Run classify, screen, extract, ask, verify, or find over many rows with a concurrency pool. Emits JSONL.")
+        .argument("<command>", `one of: ${Object.keys(BATCHABLE).join(", ")}`)
+        .argument("[args...]", "flags for that command, after --")
+        .requiredOption("-i, --input <ref>", "rows: @file or - ; plain lines, or JSONL objects with text (or state) and optional id")
+        .option("-o, --output <path>", "write JSONL records here instead of stdout")
+        .option("--concurrency <n>", "parallel requests (default 4)")
+        .option("--fail-fast", "stop scheduling new rows after the first error")
+        .allowUnknownOption()
+        .addHelpText("after", `
+Output: one JSON object per row: {index, id, ok, failed, result | error, meta}. Rows keep input order.
+        --format json collects rows into one array; --format csv|tsv|md prints a summary table (id, ok,
+        failed, result). --pluck <path> prints one value per row, e.g. --pluck result.label.
+Exit:   1 if any row errored, 2 if any row matched the command's --fail-on, else 0.
+
+Examples:
+  jev batch classify --input @tickets.txt -- --labels billing,technical,sales --other
+  jev batch screen -i @pages.jsonl -o results.jsonl --concurrency 8 -- --purpose "extract pricing"
+  jev batch extract -i @emails.jsonl -- --want sender=email --want date
+  jev batch verify -i @claims.txt -- --evidence @spec.md --fail-on contradicted,unsupported`)
+        .action(async (command, args, flags, cmd) => {
+        await run((ctx) => batchAction(command, args.filter((a) => a !== "--"), flags, ctx), cmd);
+    });
+}
+//# sourceMappingURL=batch.js.map

package/dist/commands/batch.js.map

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

package/dist/commands/classify.d.ts

@@ -0,0 +1,34 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../context.js";
+import type { BatchItemRunner } from "../core/batch.js";
+import { type AnyClassifyOutput, CLASSIFY_FAIL_CONDITIONS, type LabelDef, type Taxonomy } from "../core/classify.js";
+import { parseFailOn } from "../lib.js";
+import { type View } from "../output.js";
+export interface ClassifyFlags {
+    labels?: string;
+    labelsJson?: string;
+    taxonomy?: string;
+    multi?: boolean;
+    other?: boolean;
+    instructions?: string;
+    minConfidence?: string;
+    threshold?: string;
+    stateJson?: boolean;
+    failOn?: string;
+}
+interface Resolved {
+    mode: "single" | "multi" | "taxonomy";
+    labels: LabelDef[];
+    taxonomy?: Taxonomy;
+    minConfidence: number;
+    threshold: number;
+    failOn: ReturnType<typeof parseFailOn<(typeof CLASSIFY_FAIL_CONDITIONS)[number]>>;
+}
+export declare function resolveClassifyFlags(flags: ClassifyFlags, ctx: CommandContext): Resolved;
+export declare function resolveClassifyText(positional: string | undefined, flags: ClassifyFlags): unknown;
+export declare function classifyAction(positional: string | undefined, flags: ClassifyFlags, ctx: CommandContext): Promise<number>;
+export declare function renderClassify(out: AnyClassifyOutput, ctx: CommandContext): View;
+/** Batch: each row is classified with the shared label set. */
+export declare function prepareClassifyBatch(flags: ClassifyFlags, ctx: CommandContext): BatchItemRunner;
+export declare function registerClassify(program: Command, run: (fn: (ctx: CommandContext) => Promise<number>, cmd: Command) => Promise<void>): void;
+export {};

package/dist/commands/classify.js

@@ -0,0 +1,187 @@
+import { buildClassifyMultiRequest, buildClassifyRequest, CLASSIFY_FAIL_CONDITIONS, classifyFailed, parseLabelJson, parseLabelList, parseTaxonomy, runClassify, runClassifyMulti, runClassifyTaxonomy, } from "../core/classify.js";
+import { CliError, EXIT } from "../errors.js";
+import { parseJson, readInput, readStdin } from "../input.js";
+import { parseFailOn, parseProbability } from "../lib.js";
+import { emit, formatProbability, paint } from "../output.js";
+export function resolveClassifyFlags(flags, ctx) {
+    const sources = [flags.labels, flags.labelsJson, flags.taxonomy].filter(Boolean).length;
+    if (sources !== 1)
+        throw new CliError("Provide exactly one of --labels, --labels-json, or --taxonomy.");
+    if (flags.taxonomy && flags.multi)
+        throw new CliError("--multi cannot be combined with --taxonomy.");
+    const minConfidence = parseProbability("--min-confidence", flags.minConfidence, ctx.config.classify.minConfidence);
+    const threshold = parseProbability("--threshold", flags.threshold, ctx.config.classify.threshold);
+    const failOn = parseFailOn(flags.failOn, CLASSIFY_FAIL_CONDITIONS, []);
+    try {
+        if (flags.taxonomy) {
+            const taxonomy = parseTaxonomy(parseJson(readInput(flags.taxonomy, "taxonomy"), "taxonomy"));
+            return { mode: "taxonomy", labels: [], taxonomy, minConfidence, threshold, failOn };
+        }
+        const labels = flags.labels
+            ? parseLabelList(flags.labels)
+            : parseLabelJson(parseJson(readInput(flags.labelsJson, "labels"), "labels"));
+        if (labels.length < (flags.multi ? 1 : 2)) {
+            throw new CliError(flags.multi ? "Provide at least one label." : "Provide at least two labels (or use --multi).");
+        }
+        return { mode: flags.multi ? "multi" : "single", labels, minConfidence, threshold, failOn };
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw new CliError(err.message);
+    }
+}
+export function resolveClassifyText(positional, flags) {
+    let raw;
+    if (positional !== undefined)
+        raw = readInput(positional, "text");
+    else if (!process.stdin.isTTY)
+        raw = readStdin("text");
+    else
+        throw new CliError("Provide text as an argument, @file, or pipe it on stdin.");
+    return flags.stateJson ? parseJson(raw, "text") : raw;
+}
+async function classifyOne(text, r, flags, ctx) {
+    const ask = ctx.ask();
+    if (r.mode === "taxonomy") {
+        return runClassifyTaxonomy(ask, {
+            text,
+            taxonomy: r.taxonomy,
+            instructions: flags.instructions,
+            other: Boolean(flags.other),
+            minConfidence: r.minConfidence,
+        });
+    }
+    if (r.mode === "multi") {
+        return runClassifyMulti(ask, {
+            text,
+            labels: r.labels,
+            instructions: flags.instructions,
+            threshold: r.threshold,
+        });
+    }
+    return runClassify(ask, {
+        text,
+        labels: r.labels,
+        instructions: flags.instructions,
+        other: Boolean(flags.other),
+        minConfidence: r.minConfidence,
+    });
+}
+export async function classifyAction(positional, flags, ctx) {
+    const r = resolveClassifyFlags(flags, ctx);
+    const text = resolveClassifyText(positional, flags);
+    if (ctx.dryRun) {
+        if (r.mode === "taxonomy") {
+            emit({ ...ctx.output, format: "json" }, {
+                model: ctx.config.model,
+                note: "taxonomy runs one request per level; showing the first",
+                state: text,
+                taxonomy: r.taxonomy,
+            }, () => ({}));
+            return EXIT.OK;
+        }
+        const built = r.mode === "multi"
+            ? buildClassifyMultiRequest({ text, labels: r.labels, instructions: flags.instructions })
+            : buildClassifyRequest({
+                text,
+                labels: r.labels,
+                instructions: flags.instructions,
+                other: Boolean(flags.other),
+            });
+        emit({ ...ctx.output, format: "json" }, { model: ctx.config.model, state: built.state, questions: built.questions }, () => ({}));
+        return EXIT.OK;
+    }
+    const output = await classifyOne(text, r, flags, ctx);
+    emit(ctx.output, output, () => renderClassify(output, ctx));
+    return classifyFailed(output, r.failOn) ? EXIT.JUDGMENT : EXIT.OK;
+}
+export function renderClassify(out, ctx) {
+    const c = ctx.output.color;
+    const dist = (p) => Object.entries(p)
+        .sort(([, a], [, b]) => b - a)
+        .map(([k, v]) => `${k} ${formatProbability(v)}`)
+        .join(", ");
+    const usage = { usage: out.usage, model: out.model, provider: out.provider };
+    if (out.mode === "single") {
+        const action = out.action === "review" ? paint(c, "yellow", "review") : paint(c, "dim", "auto");
+        return {
+            head: [
+                `${paint(c, ["bold", "green"], out.label ?? "?")}  conf ${formatProbability(out.confidence)}  ${action}`,
+                paint(c, "dim", `[${dist(out.probabilities)}]`),
+            ],
+            kv: [
+                ["label", out.label ?? ""],
+                ["confidence", formatProbability(out.confidence)],
+                ["action", out.action],
+                ["probabilities", dist(out.probabilities)],
+            ],
+            usage,
+        };
+    }
+    if (out.mode === "multi") {
+        const rows = out.labels.map((l) => [
+            l.applies ? paint(c, "green", "yes") : paint(c, "dim", "no"),
+            formatProbability(l.probability),
+            l.label,
+        ]);
+        return {
+            table: { columns: ["Applies", "Prob", "Label"], rows },
+            tail: [paint(c, "dim", `threshold ≥ ${out.threshold}`)],
+            usage,
+        };
+    }
+    const path = out.path.length ? out.path.join(paint(c, "dim", " > ")) : paint(c, "dim", "(none)");
+    const action = out.action === "review" ? paint(c, "yellow", "review") : paint(c, "dim", "auto");
+    return {
+        head: [
+            `${paint(c, ["bold", "green"], path)}${out.stopped_at_other ? paint(c, "yellow", "  → other") : ""}  conf ${formatProbability(out.confidence)}  ${action}`,
+            ...out.steps.map((s) => paint(c, "dim", `  ${s.label} ${formatProbability(s.confidence)}  [${dist(s.probabilities)}]`)),
+        ],
+        kv: [
+            ["path", out.path.join(" > ")],
+            ["confidence", formatProbability(out.confidence)],
+            ["action", out.action],
+        ],
+        usage,
+    };
+}
+/** Batch: each row is classified with the shared label set. */
+export function prepareClassifyBatch(flags, ctx) {
+    const r = resolveClassifyFlags(flags, ctx);
+    return async (row) => {
+        const text = row.state !== undefined && flags.stateJson
+            ? row.state
+            : flags.stateJson
+                ? parseJson(row.text, `row ${row.id}`)
+                : row.text;
+        const output = await classifyOne(text, r, flags, ctx);
+        return { output, failed: classifyFailed(output, r.failOn) };
+    };
+}
+export function registerClassify(program, run) {
+    program
+        .command("classify")
+        .description("Assign a label from a set (one, several, or down a hierarchy) with probabilities and confidence.")
+        .argument("[text]", "text to classify, @file, or - for stdin (default: stdin)")
+        .option("-l, --labels <list>", "labels: a,b,c or a:description,b:description (escape commas as \\,)")
+        .option("--labels-json <ref>", "labels as JSON: array of strings, array of {label,description}, or {label: description}")
+        .option("-t, --taxonomy <ref>", 'hierarchy as JSON, e.g. {"hardware": {"laptop": null, "phone": null}, "software": ["os","app"]}')
+        .option("--multi", "one yes/no probability per label instead of picking one")
+        .option("--other", "add an 'other' escape option (single and taxonomy modes)")
+        .option("-i, --instructions <text>", "the question to ask instead of the default")
+        .option("--min-confidence <p>", "confidence below which the result is flagged 'review' (default 0.6)")
+        .option("--threshold <p>", "--multi: probability at or above which a label applies (default 0.5)")
+        .option("--state-json", "parse the text as JSON")
+        .option("--fail-on <list>", `exit 2 when: ${CLASSIFY_FAIL_CONDITIONS.join(", ")} (--multi: nothing applied), or none (default none)`)
+        .addHelpText("after", `
+Examples:
+  jev classify @ticket.txt --labels billing,technical,sales --other
+  jev classify "Login fails after update" -l "bug:defect in existing feature,feature:new capability,question" --fail-on review
+  jev classify @post.md --multi --labels security,performance,docs --threshold 0.6
+  jev classify @item.txt --taxonomy @catalog.json --other`)
+        .action(async (text, flags, cmd) => {
+        await run((ctx) => classifyAction(text, flags, ctx), cmd);
+    });
+}
+//# sourceMappingURL=classify.js.map

package/dist/commands/classify.js.map

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

package/dist/commands/compact.d.ts

@@ -0,0 +1,29 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../context.js";
+import { type CompactOutput } from "../core/compact.js";
+import { type View } from "../output.js";
+export interface CompactFlags {
+    goal?: string;
+    keepThreshold?: string;
+    preserveRecent?: string;
+    maxStateTokens?: string;
+    maxRequestTokens?: string;
+    truncateHead?: string;
+    minReduction?: string;
+    out?: string;
+    failOn?: string;
+}
+export declare function resolveCompactOptions(flags: CompactFlags, ctx: CommandContext): {
+    goal: string | undefined;
+    keepThreshold: number;
+    preserveRecentMessages: number;
+    maxStateTokens: number;
+    maxRequestTokens: number;
+    truncateHeadChars: number;
+    minReduction: number;
+    failOn: "low-reduction"[];
+};
+export declare function loadTranscript(positional: string | undefined): import("../core/transcript.js").ParsedTranscript;
+export declare function compactAction(positional: string | undefined, flags: CompactFlags, ctx: CommandContext): Promise<number>;
+export declare function renderCompact(out: CompactOutput, ctx: CommandContext, format: string, wrote?: string): View;
+export declare function registerCompact(program: Command, run: (fn: (ctx: CommandContext) => Promise<number>, cmd: Command) => Promise<void>): void;