jevctl 0.1.0 → 0.2.0

package/dist/commands/match.js

@@ -0,0 +1,118 @@
+import { allPairs, buildMatchRequest, crossPairs, MATCH_FAIL_CONDITIONS, MAX_PAIRS, matchFailed, runMatch, } from "../core/match.js";
+import { CliError, EXIT } from "../errors.js";
+import { parseItems, parseJson, readInput } from "../input.js";
+import { parseFailOn } from "../lib.js";
+import { clip, emit, formatProbability, paint } from "../output.js";
+function toItem(v, label) {
+    if (typeof v === "string")
+        return { text: v };
+    if (v && typeof v === "object" && typeof v.text === "string") {
+        const { id, text } = v;
+        return id === undefined ? { text } : { id: String(id), text };
+    }
+    throw new CliError(`${label} must be a string or an object with a "text" field.`);
+}
+/** Pairs JSON: array of [a, b] or {left, right}. */
+export function parsePairs(raw) {
+    const parsed = parseJson(raw, "pairs");
+    if (!Array.isArray(parsed))
+        throw new CliError("pairs must be a JSON array.");
+    return parsed.map((entry, i) => {
+        if (Array.isArray(entry) && entry.length === 2)
+            return { left: toItem(entry[0], `pairs[${i}][0]`), right: toItem(entry[1], `pairs[${i}][1]`) };
+        if (entry && typeof entry === "object" && "left" in entry && "right" in entry) {
+            const e = entry;
+            return { left: toItem(e.left, `pairs[${i}].left`), right: toItem(e.right, `pairs[${i}].right`) };
+        }
+        throw new CliError(`pairs[${i}] must be [left, right] or {"left", "right"}.`);
+    });
+}
+/** Give unnamed items positional ids so results can be read back. */
+function withIds(items, prefix) {
+    return items.map((it, i) => (it.id === undefined ? { ...it, id: `${prefix}${i + 1}` } : it));
+}
+export function collectPairs(flags) {
+    const modes = [flags.pairs, flags.left || flags.right, flags.dedupe].filter(Boolean).length;
+    if (modes !== 1)
+        throw new CliError("Provide exactly one of --pairs <ref>, --left <ref> --right <ref>, or --dedupe <ref>.");
+    let pairs;
+    if (flags.pairs)
+        pairs = parsePairs(readInput(flags.pairs, "pairs"));
+    else if (flags.dedupe) {
+        const items = withIds(parseItems(readInput(flags.dedupe, "items"), "items"), "item");
+        if (items.length < 2)
+            throw new CliError("--dedupe needs at least two items.");
+        pairs = allPairs(items);
+    }
+    else {
+        if (!flags.left || !flags.right)
+            throw new CliError("--left and --right must be given together.");
+        const left = withIds(parseItems(readInput(flags.left, "left"), "left"), "L");
+        const right = withIds(parseItems(readInput(flags.right, "right"), "right"), "R");
+        pairs = crossPairs(left, right);
+    }
+    if (pairs.length === 0)
+        throw new CliError("No pairs to compare.");
+    if (pairs.length > MAX_PAIRS) {
+        throw new CliError(`${pairs.length} pairs exceeds the limit of ${MAX_PAIRS}. Block candidates first (e.g. by name prefix or postcode) and match within blocks.`);
+    }
+    return pairs;
+}
+export async function matchAction(flags, ctx) {
+    const pairs = collectPairs(flags);
+    const failOn = parseFailOn(flags.failOn, MATCH_FAIL_CONDITIONS, []);
+    if (ctx.dryRun) {
+        const { state, questions } = buildMatchRequest(pairs.slice(0, 50), flags.kind);
+        emit({ ...ctx.output, format: "json" }, {
+            model: ctx.config.model,
+            pairs: pairs.length,
+            note: pairs.length > 50 ? "showing the first request of several" : undefined,
+            state,
+            questions,
+        }, () => ({}));
+        return EXIT.OK;
+    }
+    const output = await runMatch(ctx.ask(), { pairs, kind: flags.kind });
+    emit(ctx.output, output, () => renderMatch(output, ctx));
+    return matchFailed(output, failOn) ? EXIT.JUDGMENT : EXIT.OK;
+}
+export function renderMatch(out, ctx) {
+    const c = ctx.output.color;
+    const style = (d) => d === "same" ? paint(c, "green", d) : d === "different" ? paint(c, "dim", d) : paint(c, "yellow", d);
+    const rows = out.results.map((r) => [
+        style(r.decision),
+        formatProbability(r.confidence),
+        clip(r.left === r.left_text ? r.left : `${r.left}: ${r.left_text}`, 40),
+        clip(r.right === r.right_text ? r.right : `${r.right}: ${r.right_text}`, 40),
+    ]);
+    const s = out.summary;
+    return {
+        table: { columns: ["Decision", "Conf", "Left", "Right"], rows },
+        tail: [`${s.same} same · ${s.unclear} unclear · ${s.different} different`],
+        usage: { usage: out.usage, model: out.model, provider: out.provider },
+    };
+}
+export function registerMatch(program, run) {
+    program
+        .command("match")
+        .description("Decide whether pairs of records describe the same thing: same, different, or unclear (send to a person).")
+        .option("-p, --pairs <ref>", 'JSON pairs: [["a","b"], ...] or [{"left": {...}, "right": {...}}, ...]')
+        .option("--left <ref>", "JSON items; every left item is compared with every right item")
+        .option("--right <ref>", "JSON items for --left")
+        .option("-d, --dedupe <ref>", "JSON items; every pair within the list is compared")
+        .option("-k, --kind <text>", 'what the records are, e.g. "products in a catalogue" or "customer contacts"')
+        .option("--fail-on <list>", `exit 2 when any pair is: ${MATCH_FAIL_CONDITIONS.join(", ")}, or none (default none)`)
+        .addHelpText("after", `
+Items are strings or {id, text}. Up to ${MAX_PAIRS} pairs per call, sent in groups of 50.
+The decision is the most likely of three levels; there is no threshold to tune. "unclear" is a
+real outcome meaning a person should look, not a low-confidence "same".
+
+Examples:
+  jev match --dedupe @contacts.json --kind "customer contacts" --fail-on same
+  jev match --left @our-catalog.json --right @supplier-feed.json --kind "beer products" --json
+  jev match --pairs @candidate-pairs.json`)
+        .action(async (flags, cmd) => {
+        await run((ctx) => matchAction(flags, ctx), cmd);
+    });
+}
+//# sourceMappingURL=match.js.map

package/dist/commands/match.js.map

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

package/dist/commands/models.js

@@ -1,6 +1,6 @@
 import { TypeSafeClient } from "@typesafe-ai/sdk";
 import { CliError, EXIT } from "../errors.js";
-import { emit, paint, table } from "../output.js";
+import { emit, paint } from "../output.js";
 import { resolveProvider } from "../provider.js";
 export async function modelsAction(ctx, env) {
     const provider = resolveProvider(env, ctx.config.provider);
@@ -14,14 +14,16 @@ export async function modelsAction(ctx, env) {
     });
     const models = await client.models.list();
     const payload = { command: "models", provider, models, default: ctx.config.model };
-    emit(ctx.output, payload, () => {
-        const rows = models.map((m) => [
-            m.name === ctx.config.model ? paint(ctx.output.color, "green", m.name) : m.name,
-            m.release_date,
-            m.description,
-        ]);
-        return table([["Name", "Released", "Description"], ...rows], { color: ctx.output.color });
-    });
+    emit(ctx.output, payload, () => ({
+        table: {
+            columns: ["Name", "Released", "Description"],
+            rows: models.map((m) => [
+                m.name === ctx.config.model ? paint(ctx.output.color, "green", m.name) : m.name,
+                m.release_date,
+                m.description,
+            ]),
+        },
+    }));
     return EXIT.OK;
 }
 export function registerModels(program, run) {
@@ -29,7 +31,7 @@ export function registerModels(program, run) {
         .command("models")
         .description("List the models available to your TypeSafe account.")
         .action(async (_flags, cmd) => {
-        await run((ctx) => modelsAction(ctx, process.env), cmd);
+        await run((ctx) => modelsAction(ctx, ctx.env), cmd);
     });
 }
 //# sourceMappingURL=models.js.map

package/dist/commands/models.js.map

@@ -1 +1 @@
-{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/commands/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAmB,EAAE,GAAsB;IAC5E,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3D,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAChB,4DAA4D,QAAQ,0BAA0B,CAC/F,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,MAAM,EAAE,GAAG,CAAC,gBAAgB;QAC5B,OAAO,EAAE,GAAG,CAAC,iBAAiB,IAAI,SAAS;QAC3C,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS;KAC9B,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACnF,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE;QAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC7B,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;YAC/E,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,WAAW;SACd,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAgB,EAChB,GAAkF;IAElF,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qDAAqD,CAAC;SAClE,MAAM,CAAC,KAAK,EAAE,MAAe,EAAE,GAAY,EAAE,EAAE;QAC9C,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/commands/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAmB,EAAE,GAAsB;IAC5E,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3D,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAChB,4DAA4D,QAAQ,0BAA0B,CAC/F,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,MAAM,EAAE,GAAG,CAAC,gBAAgB;QAC5B,OAAO,EAAE,GAAG,CAAC,iBAAiB,IAAI,SAAS;QAC3C,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS;KAC9B,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACnF,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/B,KAAK,EAAE;YACL,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC;YAC5C,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACtB,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC/E,CAAC,CAAC,YAAY;gBACd,CAAC,CAAC,WAAW;aACd,CAAC;SACH;KACF,CAAC,CAAC,CAAC;IACJ,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAgB,EAChB,GAAkF;IAElF,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qDAAqD,CAAC;SAClE,MAAM,CAAC,KAAK,EAAE,MAAe,EAAE,GAAY,EAAE,EAAE;QAC9C,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/rerank.d.ts

@@ -0,0 +1,15 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../context.js";
+import type { BatchItemRunner } from "../core/batch.js";
+import { type RerankOutput } from "../core/rerank.js";
+import { type View } from "../output.js";
+import { type FindFlags } from "./find.js";
+export interface RerankFlags extends Pick<FindFlags, "candidates" | "files" | "lines" | "topK" | "failOn"> {
+    min?: string;
+    criteria?: string;
+}
+export declare function rerankAction(query: string, flags: RerankFlags, ctx: CommandContext): Promise<number>;
+export declare function renderRerank(out: RerankOutput, ctx: CommandContext): View;
+/** Batch: each row is a query reranked against the shared candidates. */
+export declare function prepareRerankBatch(flags: RerankFlags, ctx: CommandContext): BatchItemRunner;
+export declare function registerRerank(program: Command, run: (fn: (ctx: CommandContext) => Promise<number>, cmd: Command) => Promise<void>): void;

package/dist/commands/rerank.js

@@ -0,0 +1,82 @@
+import { buildRerankRequest, RERANK_FAIL_CONDITIONS, rerankFailed, runRerank, } from "../core/rerank.js";
+import { CliError, EXIT } from "../errors.js";
+import { parseFailOn, parseProbability } from "../lib.js";
+import { clip, emit, formatProbability, paint } from "../output.js";
+import { collectCandidates } from "./find.js";
+function resolve(flags, ctx) {
+    const candidates = collectCandidates(flags);
+    const topK = flags.topK === undefined ? ctx.config.rerank.topK : Number(flags.topK);
+    if (!Number.isInteger(topK) || topK < 1 || topK > 250)
+        throw new CliError("--top-k must be an integer from 1 to 250.");
+    const min = parseProbability("--min", flags.min, ctx.config.rerank.min);
+    const failOn = parseFailOn(flags.failOn, RERANK_FAIL_CONDITIONS, []);
+    return { candidates, topK, min, failOn };
+}
+export async function rerankAction(query, flags, ctx) {
+    const { candidates, topK, min, failOn } = resolve(flags, ctx);
+    if (ctx.dryRun) {
+        const { state, questions } = buildRerankRequest({ query, candidates, criteria: flags.criteria });
+        emit({ ...ctx.output, format: "json" }, { model: ctx.config.model, state, questions }, () => ({}));
+        return EXIT.OK;
+    }
+    const output = await runRerank(ctx.ask(), { query, candidates, topK, min, criteria: flags.criteria });
+    emit(ctx.output, output, () => renderRerank(output, ctx));
+    return rerankFailed(output, failOn) ? EXIT.JUDGMENT : EXIT.OK;
+}
+export function renderRerank(out, ctx) {
+    const c = ctx.output.color;
+    const rows = out.ranked.map((h, i) => [
+        String(i + 1),
+        h.kept
+            ? paint(c, "green", formatProbability(h.relevance))
+            : paint(c, "dim", formatProbability(h.relevance)),
+        h.kept ? "keep" : paint(c, "dim", "drop"),
+        h.id,
+        clip(h.text, 60),
+    ]);
+    return {
+        head: [
+            `${out.kept.length} of ${out.ranked.length} shown are relevant (min ${out.min})  ${paint(c, "dim", out.query)}`,
+        ],
+        table: { columns: ["#", "Rel", "Keep", "Id", "Text"], rows },
+        usage: { usage: out.usage, model: out.model, provider: out.provider },
+    };
+}
+/** Batch: each row is a query reranked against the shared candidates. */
+export function prepareRerankBatch(flags, ctx) {
+    const { candidates, topK, min, failOn } = resolve(flags, ctx);
+    return async (row) => {
+        const output = await runRerank(ctx.ask(), {
+            query: row.text,
+            candidates,
+            topK,
+            min,
+            criteria: flags.criteria,
+        });
+        return { output, failed: rerankFailed(output, failOn) };
+    };
+}
+export function registerRerank(program, run) {
+    program
+        .command("rerank")
+        .description("Score each candidate's relevance to a query independently and sort. Use on search results before showing or using them.")
+        .argument("<query>", "what the results should be relevant to")
+        .option("-c, --candidates <ref>", "JSON candidates (@file or -): array of strings, array of {id,text}, or {id: text}")
+        .option("-f, --files <paths...>", "treat each file as a candidate (id = path)")
+        .option("-l, --lines <ref>", "treat each non-empty line of @file or - as a candidate (id = L<line number>)")
+        .option("-k, --top-k <n>", "how many ranked results to return (default 10)")
+        .option("--min <p>", "relevance at or above which a candidate is kept (default 0.5)")
+        .option("--criteria <text>", 'what counts as relevant, e.g. "a passage stating the legal rule, not commentary"')
+        .option("--fail-on <list>", "exit 2 when: empty (nothing kept), or none (default none)")
+        .addHelpText("after", `
+Unlike find, rerank scores every candidate on its own, so several can be relevant or none can.
+Use find to pick the single best answer; use rerank to filter and order a result list.
+
+Examples:
+  jev rerank "how do I rotate API keys" --candidates @bm25-top30.json -k 10
+  jev rerank "statute of limitations for contract claims" --lines @passages.txt --min 0.7 --fail-on empty`)
+        .action(async (query, flags, cmd) => {
+        await run((ctx) => rerankAction(query, flags, ctx), cmd);
+    });
+}
+//# sourceMappingURL=rerank.js.map

package/dist/commands/rerank.js.map

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

package/dist/commands/route.d.ts

@@ -0,0 +1,19 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../context.js";
+import type { BatchItemRunner } from "../core/batch.js";
+import { type RouteOutput } from "../core/route.js";
+import { type View } from "../output.js";
+export interface RouteFlags {
+    handlers?: string;
+    handlersJson?: string;
+    instructions?: string;
+    minConfidence?: string;
+    stateJson?: boolean;
+    failOn?: string;
+}
+export declare function resolveRequest(positional: string | undefined, flags: RouteFlags): unknown;
+export declare function routeAction(positional: string | undefined, flags: RouteFlags, ctx: CommandContext): Promise<number>;
+export declare function renderRoute(out: RouteOutput, ctx: CommandContext): View;
+/** Batch: each row is a request routed with the shared handlers. */
+export declare function prepareRouteBatch(flags: RouteFlags, ctx: CommandContext): BatchItemRunner;
+export declare function registerRoute(program: Command, run: (fn: (ctx: CommandContext) => Promise<number>, cmd: Command) => Promise<void>): void;

package/dist/commands/route.js

@@ -0,0 +1,120 @@
+import { buildRouteRequest, parseHandlerList, parseHandlers, ROUTE_FAIL_CONDITIONS, routeFailed, runRoute, } from "../core/route.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";
+function resolve(flags, ctx) {
+    if (Boolean(flags.handlers) === Boolean(flags.handlersJson)) {
+        throw new CliError("Provide exactly one of --handlers <list> or --handlers-json <ref>.");
+    }
+    let handlers;
+    try {
+        handlers = flags.handlers
+            ? parseHandlerList(flags.handlers)
+            : parseHandlers(parseJson(readInput(flags.handlersJson, "handlers"), "handlers"));
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw new CliError(err.message);
+    }
+    const minConfidence = parseProbability("--min-confidence", flags.minConfidence, ctx.config.route.minConfidence);
+    const failOn = parseFailOn(flags.failOn, ROUTE_FAIL_CONDITIONS, []);
+    return { handlers, minConfidence, failOn };
+}
+export function resolveRequest(positional, flags) {
+    let raw;
+    if (positional !== undefined)
+        raw = readInput(positional, "request");
+    else if (!process.stdin.isTTY)
+        raw = readStdin("request");
+    else
+        throw new CliError("Provide the request as an argument, @file, or pipe it on stdin.");
+    return flags.stateJson ? parseJson(raw, "request") : raw;
+}
+export async function routeAction(positional, flags, ctx) {
+    const { handlers, minConfidence, failOn } = resolve(flags, ctx);
+    const request = resolveRequest(positional, flags);
+    if (ctx.dryRun) {
+        const { state, questions } = buildRouteRequest({ request, handlers, instructions: flags.instructions });
+        emit({ ...ctx.output, format: "json" }, { model: ctx.config.model, state, questions }, () => ({}));
+        return EXIT.OK;
+    }
+    const output = await runRoute(ctx.ask(), {
+        request,
+        handlers,
+        instructions: flags.instructions,
+        minConfidence,
+    });
+    emit(ctx.output, output, () => renderRoute(output, ctx));
+    return routeFailed(output, failOn) ? EXIT.JUDGMENT : EXIT.OK;
+}
+export function renderRoute(out, ctx) {
+    const c = ctx.output.color;
+    const dist = Object.entries(out.probabilities)
+        .sort(([, a], [, b]) => b - a)
+        .map(([k, v]) => `${k} ${formatProbability(v)}`)
+        .join(", ");
+    const head = [
+        out.handler === null
+            ? `${paint(c, ["bold", "yellow"], "no handler")}  conf ${formatProbability(out.confidence)}`
+            : `${paint(c, ["bold", "green"], out.handler)}  conf ${formatProbability(out.confidence)}  ${out.action === "review" ? paint(c, "yellow", "review") : paint(c, "dim", "auto")}`,
+        paint(c, "dim", `[${dist}]`),
+    ];
+    const kv = [
+        ["handler", out.handler ?? ""],
+        ["confidence", formatProbability(out.confidence)],
+        ["action", out.action],
+    ];
+    for (const [name, a] of Object.entries(out.args)) {
+        const extra = a.type === "noul" ? `p ${formatProbability(a.probability)}` : `conf ${formatProbability(a.confidence)}`;
+        head.push(`  ${name} = ${a.value === null ? paint(c, "dim", "unspecified") : paint(c, "green", String(a.value))}  ${paint(c, "dim", extra)}`);
+        kv.push([`arg.${name}`, a.value === null ? "" : String(a.value)]);
+    }
+    return { head, kv, usage: { usage: out.usage, model: out.model, provider: out.provider } };
+}
+/** Batch: each row is a request routed with the shared handlers. */
+export function prepareRouteBatch(flags, ctx) {
+    const { handlers, minConfidence, failOn } = resolve(flags, ctx);
+    return async (row) => {
+        const request = row.state !== undefined && typeof row.state !== "string"
+            ? row.state
+            : flags.stateJson
+                ? parseJson(row.text, `row ${row.id}`)
+                : row.text;
+        const output = await runRoute(ctx.ask(), {
+            request,
+            handlers,
+            instructions: flags.instructions,
+            minConfidence,
+        });
+        return { output, failed: routeFailed(output, failOn) };
+    };
+}
+export function registerRoute(program, run) {
+    program
+        .command("route")
+        .description("Pick the handler for a request and fill its arguments from closed sets, in one call.")
+        .argument("[request]", "the request text, @file, or - for stdin (default: stdin)")
+        .option("-H, --handlers <list>", "handlers without arguments: name:description,name2:description")
+        .option("--handlers-json <ref>", "handlers with arguments as JSON (see below)")
+        .option("-i, --instructions <text>", "the routing question to ask instead of the default")
+        .option("--min-confidence <p>", "confidence below which the route is flagged 'review' (default 0.6)")
+        .option("--state-json", "parse the request as JSON")
+        .option("--fail-on <list>", `exit 2 when: ${ROUTE_FAIL_CONDITIONS.join(", ")} (no handler fits), or none (default none)`)
+        .addHelpText("after", `
+Handlers JSON: {"name": "description" | null | {"description": "...", "args": {"argName": spec}}}
+  spec: {"type": "choice", "options": ["a","b"] | {"a": "desc"}, "instructions"?: "..."}
+        {"type": "noul", "instructions": "yes/no question"}
+        {"type": "score", "levels": ["low","mid","high"], "instructions"?: "..."}
+A "none" option is always added so the model can say nothing fits (action: none).
+Argument questions for every handler run in the same request; only the chosen handler's are returned.
+
+Examples:
+  jev route "cancel my order and refund me" -H "refund:money back,cancel:stop an order,support:everything else"
+  jev route @message.txt --handlers-json @handlers.json --fail-on review,unrouted --json`)
+        .action(async (request, flags, cmd) => {
+        await run((ctx) => routeAction(request, flags, ctx), cmd);
+    });
+}
+//# sourceMappingURL=route.js.map

package/dist/commands/route.js.map

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

package/dist/commands/screen.d.ts

@@ -1,6 +1,8 @@
 import type { Command } from "commander";
 import type { CommandContext } from "../context.js";
+import type { BatchItemRunner } from "../core/batch.js";
 import { type ScreenOutput } from "../core/screen.js";
+import { type View } from "../output.js";
 export interface ScreenFlags {
     purpose?: string;
     blockAt?: string;
@@ -9,5 +11,7 @@ export interface ScreenFlags {
 }
 export declare function resolveScreenText(positional: string | undefined): string;
 export declare function screenAction(positional: string | undefined, flags: ScreenFlags, ctx: CommandContext): Promise<number>;
-export declare function renderScreen(out: ScreenOutput, ctx: CommandContext): string;
+export declare function renderScreen(out: ScreenOutput, ctx: CommandContext): View;
 export declare function registerScreen(program: Command, run: (fn: (ctx: CommandContext) => Promise<number>, cmd: Command) => Promise<void>): void;
+/** Batch: each row's text is screened with the shared flags. */
+export declare function prepareScreenBatch(flags: ScreenFlags, ctx: CommandContext): BatchItemRunner;

package/dist/commands/screen.js

@@ -2,7 +2,7 @@ import { buildScreenRequest, runScreen, SCREEN_FAIL_CONDITIONS, screenFailed, }
 import { CliError, EXIT } from "../errors.js";
 import { readInput, readStdin } from "../input.js";
 import { parseFailOn, parseProbability } from "../lib.js";
-import { emit, formatProbability, paint, usageLine } from "../output.js";
+import { emit, formatProbability, paint } from "../output.js";
 export function resolveScreenText(positional) {
     if (positional !== undefined)
         return readInput(positional, "text");
@@ -17,7 +17,7 @@ export async function screenAction(positional, flags, ctx) {
     const failOn = parseFailOn(flags.failOn, SCREEN_FAIL_CONDITIONS, ["block"]);
     if (ctx.dryRun) {
         const { state, questions } = buildScreenRequest({ text, purpose: flags.purpose });
-        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 runScreen(ctx.ask(), { text, purpose: flags.purpose, blockAt, reviewAt });
@@ -35,14 +35,21 @@ export function renderScreen(out, ctx) {
                 ? paint(c, ["bold", "dim"], action.toUpperCase())
                 : paint(c, ["bold", "green"], action.toUpperCase());
     const p = out.probabilities;
-    const lines = [
-        `${styled}  ${out.recommendation.reason}`,
-        `injection ${formatProbability(p.injection)} · substance ${formatProbability(p.substance)} · relevance ${formatProbability(p.relevance)}`,
-        paint(c, "dim", `thresholds: block ≥ ${out.thresholds.block_at}, review ≥ ${out.thresholds.review_at}`),
-    ];
-    if (!ctx.output.quiet)
-        lines.push(paint(c, "dim", usageLine(out.usage, out.model, out.provider)));
-    return lines.join("\n");
+    return {
+        head: [
+            `${styled}  ${out.recommendation.reason}`,
+            `injection ${formatProbability(p.injection)} · substance ${formatProbability(p.substance)} · relevance ${formatProbability(p.relevance)}`,
+            paint(c, "dim", `thresholds: block ≥ ${out.thresholds.block_at}, review ≥ ${out.thresholds.review_at}`),
+        ],
+        kv: [
+            ["action", action],
+            ["reason", out.recommendation.reason],
+            ["injection", formatProbability(p.injection)],
+            ["substance", formatProbability(p.substance)],
+            ["relevance", formatProbability(p.relevance)],
+        ],
+        usage: { usage: out.usage, model: out.model, provider: out.provider },
+    };
 }
 export function registerScreen(program, run) {
     program
@@ -61,4 +68,14 @@ Examples:
         await run((ctx) => screenAction(text, flags, ctx), cmd);
     });
 }
+/** Batch: each row's text is screened with the shared flags. */
+export function prepareScreenBatch(flags, ctx) {
+    const blockAt = parseProbability("--block-at", flags.blockAt, ctx.config.screen.blockAt);
+    const reviewAt = parseProbability("--review-at", flags.reviewAt, ctx.config.screen.reviewAt);
+    const failOn = parseFailOn(flags.failOn, SCREEN_FAIL_CONDITIONS, ["block"]);
+    return async (row) => {
+        const output = await runScreen(ctx.ask(), { text: row.text, purpose: flags.purpose, blockAt, reviewAt });
+        return { output, failed: screenFailed(output, failOn) };
+    };
+}
 //# sourceMappingURL=screen.js.map

package/dist/commands/screen.js.map

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

package/dist/commands/verify.d.ts

@@ -1,6 +1,8 @@
 import type { Command } from "commander";
 import type { CommandContext } from "../context.js";
+import type { BatchItemRunner } from "../core/batch.js";
 import { type VerifyOutput } from "../core/verify.js";
+import { type View } from "../output.js";
 export interface VerifyFlags {
     evidence?: string[];
     evidenceJson?: string;
@@ -14,5 +16,7 @@ export declare function collectEvidence(flags: VerifyFlags): {
 }[];
 export declare function collectClaims(positional: string[], flags: VerifyFlags): string[];
 export declare function verifyAction(positional: string[], flags: VerifyFlags, ctx: CommandContext): Promise<number>;
-export declare function renderVerify(out: VerifyOutput, ctx: CommandContext): string;
+export declare function renderVerify(out: VerifyOutput, ctx: CommandContext): View;
 export declare function registerVerify(program: Command, run: (fn: (ctx: CommandContext) => Promise<number>, cmd: Command) => Promise<void>): void;
+/** Batch: each row is one claim checked against the shared evidence. */
+export declare function prepareVerifyBatch(flags: VerifyFlags, ctx: CommandContext): BatchItemRunner;