plures 1.18.0 → 1.22.0

package/README.md

@@ -52,10 +52,11 @@ if (event.type === "task.completed" && event.data.result?.agreement === 1) {
 - `plures.tasks.retrieve(id)`, `plures.tasks.list({ status?, limit?, starting_after?, app? })`, `plures.tasks.cancel(id)`
 - `new Plures(key, { app: "support-agent" })` or `PLURES_APP`: send everything to one of your apps. `plures.apps.list()`, `.create({ name, id? })`, `.retrieve(id)`, `.update(id, { name?, id?, default? })`, `.del(id)`. Each app keeps its own tasks, ledger view, map and quality.
 - `plures.maps.guide()`, `.retrieve(app)`, `.upload(app, map, { branch? })` (a branch other than main gets its own map, compared with main and noted on its pull request), `.setCheckpoint(app, id, status)`: the agent map, where your agent needs a person. Or run `npx plures map` in your repo: your own coding agent reads the code and only the map is sent.
-- `plures.maps.createKey(app, { label? })`, `.keys(app)`, `.revokeKey(app, id)`: map keys for CI, which can only read and upload that app's map. `.workflow(app, branch?)` returns the GitHub Action that maps on every push; `npx plures map workflow` writes it to `.github/workflows/plures-map.yml`. Or use **Map with GitHub** on the app's map page and Plures opens the pull request for you, then **Turn on mapping** merges it. `plures.maps.startRun(app)` and `.runs(app)`: in CI with no Claude key, `npx plures map` starts a run where Plures runs Claude (first map free, then Claude's cost plus 30%, at most $5).
+- `plures.maps.createKey(app, { label? })`, `.keys(app)`, `.revokeKey(app, id)`: map keys for CI, which can only read and upload that app's map. `.workflow(app, branch?)` returns the GitHub Action that maps on every push; `npx plures map workflow` writes it to `.github/workflows/plures-map.yml`. Or use **Map with GitHub** on the app's map page and Plures opens the pull request for you, then **Turn on mapping** merges it. `plures.maps.startRun(app)` and `.runs(app)`: in CI with no Claude key, `npx plures map` starts a run where Plures runs Claude (Claude at cost, at most $5 a run). `plures.maps.estimate(app, "map" | "drift")` shows what the next map or drift fix costs before it starts: the Plures engine fee, 5¢ a step of the app's map (the first map of each app is free; branch maps are free), plus Claude at cost when Plures runs it. `npx plures map` and `npx plures drift fix` check it first and stop if your credit can't cover it. A drift fix is paid by outcome: each quality point it wins back, once people have graded the new outputs, costs 20¢ a step of the map ($3 to $15 a point), at most $500 a fix, with Claude included; no better or worse is free.
 - In your terminal, `npx plures map` opens your map page so you can watch it build (`--no-open` to skip), keeps one live line of what it's reading, and ends by drawing the map's flows with the checks Plures suggests. On GitHub and other CI it prints a plain log.
 - `npx plures map` shows each file as Claude Code reads it and sends the file names (never their contents) to Plures, so the map page shows the reading live and the map builds itself when it lands. `plures.maps.progress(app, { session, phase, events })` is the call behind it.
 - `plures.github.repos()`, `.connect(app, "owner/repo")`, `.turnOn(app)`, `.run(app)` (map now), `.status(app)`, `.disconnect(app)`: Map with GitHub from code. Plures sets the repo's map key secret and opens a pull request adding the workflow; `turnOn` merges it. Installing the Plures GitHub App needs a browser once (`install_url`). From a terminal: `npx plures map github connect`, then `npx plures map github on`; `npx plures map github run` maps again now.
+- `plures.quality.suggestions(app)`: rubrics the Plures engine suggests for the app, from what graders found in its answers (with evidence) and from its agent map (with the step and file).
 - `plures.quality.sample({ rubric, output, input? })`: send every output; a share is graded by people against the rubric, with personal details taken out first. `plures.quality.rubrics.create({ name, question, options, sample_rate })`, `.retrieve(name)` (score by day, this week against the four before, drift), `.list()`, `.update()`, `.del()`. `plures.quality.compare({ release, input, a, b })` and `plures.quality.release(name)` for blind release checks. `plures.quality.export(rubric)` returns graded samples for evals or fine tuning.
 - `plures.testMix.set({ unanimous: 70, split: 20, tie: 5, expired: 5 })`, `.get()`, `.clear()`: with a test key, makes a share of test tasks split, tie or expire at random so you can test routing to your team without changing your agent. A task can override it with `metadata.test_mix`, and `metadata.test_outcome` beats both.
 - `plures.routing.get()`, `plures.routing.set({ groups, rules, team })`: named teams of your own people and rules by category, like `{ groups: [{ name: "Finance", emails: ["ap@acme.com"] }], rules: [{ category: "refunds", route: "team", group: "Finance" }] }`. What you send replaces what's there; the rest stays.

package/dist/{chunk-RKIJTDS3.js → chunk-3P2G67SF.js}

@@ -1,5 +1,5 @@
 // src/index.ts
-var VERSION = "1.18.0";
+var VERSION = "1.22.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -107,8 +107,12 @@ var Plures = class {
     createKey: (app, opts = {}) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app)}/map_keys`, opts),
     keys: (app) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/map_keys`),
     revokeKey: (app, id) => this.req("DELETE", `/api/v1/apps/${encodeURIComponent(app)}/map_keys/${encodeURIComponent(id)}`),
+    /** What the next map or drift fix will cost before it starts. A map: the Plures engine fee, per step of the app's map
+     * (the first map of each app is free), and Claude at cost if Plures runs it. A drift fix: paid by outcome,
+     * drift_fix.per_point_cents for each quality point it wins back, at most drift_fix.max_cents, Claude included. blocked says why it can't start. */
+    estimate: (app, kind = "map", opts = {}) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/map_estimate?for=${kind}${opts.case ? `&case=${encodeURIComponent(opts.case)}` : ""}`),
     /** Starts a map run where Plures runs Claude (CI with no Anthropic key). npx plures map does this. */
-    startRun: (app) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app)}/map_runs`, {}),
+    startRun: (app, opts = {}) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app)}/map_runs`, opts),
     runs: (app) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/map_runs`),
     /** While mapping, which files the coding agent is reading, shown live on the map page. File names only. npx plures map does this. */
     progress: (app, p) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app)}/map/progress`, p),
@@ -144,6 +148,9 @@ var Plures = class {
    * early, and compare two versions blind before you ship. Personal details are taken out first.
    */
   quality = {
+    /** Rubrics the Plures engine suggests for an app: from what graders found in its answers (source "grades", with
+     * evidence) and from its agent map (source "map", with the step and file). Add one with rubrics.create. */
+    suggestions: (app) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/rubric_suggestions`),
     /** Send every output; the rubric's sample rate decides which ones people grade. */
     sample: (p) => this.req("POST", "/api/v1/samples", p),
     /** A blind release check: a is the current version's output, b the new one's, for the same input. */

package/dist/cli.cjs

@@ -30,7 +30,7 @@ var import_node_path = require("path");
 var import_node_fs = require("fs");
 
 // src/index.ts
-var VERSION = "1.18.0";
+var VERSION = "1.22.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -138,8 +138,12 @@ var Plures = class {
     createKey: (app2, opts = {}) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app2)}/map_keys`, opts),
     keys: (app2) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app2)}/map_keys`),
     revokeKey: (app2, id) => this.req("DELETE", `/api/v1/apps/${encodeURIComponent(app2)}/map_keys/${encodeURIComponent(id)}`),
+    /** What the next map or drift fix will cost before it starts. A map: the Plures engine fee, per step of the app's map
+     * (the first map of each app is free), and Claude at cost if Plures runs it. A drift fix: paid by outcome,
+     * drift_fix.per_point_cents for each quality point it wins back, at most drift_fix.max_cents, Claude included. blocked says why it can't start. */
+    estimate: (app2, kind = "map", opts = {}) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app2)}/map_estimate?for=${kind}${opts.case ? `&case=${encodeURIComponent(opts.case)}` : ""}`),
     /** Starts a map run where Plures runs Claude (CI with no Anthropic key). npx plures map does this. */
-    startRun: (app2) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app2)}/map_runs`, {}),
+    startRun: (app2, opts = {}) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app2)}/map_runs`, opts),
     runs: (app2) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app2)}/map_runs`),
     /** While mapping, which files the coding agent is reading, shown live on the map page. File names only. npx plures map does this. */
     progress: (app2, p) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app2)}/map/progress`, p),
@@ -175,6 +179,9 @@ var Plures = class {
    * early, and compare two versions blind before you ship. Personal details are taken out first.
    */
   quality = {
+    /** Rubrics the Plures engine suggests for an app: from what graders found in its answers (source "grades", with
+     * evidence) and from its agent map (source "map", with the step and file). Add one with rubrics.create. */
+    suggestions: (app2) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app2)}/rubric_suggestions`),
     /** Send every output; the rubric's sample rate decides which ones people grade. */
     sample: (p) => this.req("POST", "/api/v1/samples", p),
     /** A blind release check: a is the current version's output, b the new one's, for the same input. */
@@ -512,8 +519,7 @@ async function upload(file) {
   }
   if (!fancy) console.log(dim(`Sending the map to Plures. No source code is sent.`));
   let m;
-  const gitBranch = (0, import_node_child_process.spawnSync)("git", ["rev-parse", "--abbrev-ref", "HEAD"], { encoding: "utf8" }).stdout?.trim();
-  const branchName = process.env.PLURES_BRANCH || process.env.GITHUB_HEAD_REF || process.env.GITHUB_REF_NAME || (gitBranch && gitBranch !== "HEAD" ? gitBranch : "");
+  const branchName = currentBranch();
   try {
     m = await client().maps.upload(app, map2, branchName ? { branch: branchName } : {});
   } catch (e) {
@@ -563,6 +569,14 @@ With plures-mcp connected, just ask: ${cyan("Map this app for Plures")}`);
     return;
   }
   const before = (0, import_node_fs.existsSync)(FILE) ? (0, import_node_fs.statSync)(FILE).mtimeMs : 0;
+  const est = await client().maps.estimate(app).catch(() => null);
+  if (est) {
+    const br = currentBranch();
+    const main2 = !br || br === "main" || br === "master";
+    if (est.blocked && main2) die(est.blocked);
+    if (main2 && est.engine_fee.free) console.log(dim("Plures engine: this app's first map is free."));
+    else if (main2 && est.engine_fee.cents) console.log(dim(`Plures engine: about $${(est.engine_fee.cents / 100).toFixed(2)} (${est.engine_fee.steps} steps at ${est.engine_fee.per_step_cents}\xA2), from your credit when the map uploads.`));
+  }
   const childEnv = { ...process.env };
   const ownClaude = Boolean(process.env.ANTHROPIC_API_KEY || process.env.CLAUDE_CODE_OAUTH_TOKEN || process.env.ANTHROPIC_AUTH_TOKEN);
   if (!ownClaude && (process.env.CI || argv.includes("--plures-claude"))) {
@@ -821,6 +835,10 @@ ${cyan("\u2713")} The check is on the branch ${bold(br)}. Review it with ${cyan(
     die(e instanceof PluresError ? e.message : String(e));
   }
 }
+function currentBranch() {
+  const gitBranch = (0, import_node_child_process.spawnSync)("git", ["rev-parse", "--abbrev-ref", "HEAD"], { encoding: "utf8" }).stdout?.trim();
+  return process.env.PLURES_BRANCH || process.env.GITHUB_HEAD_REF || process.env.GITHUB_REF_NAME || (gitBranch && gitBranch !== "HEAD" ? gitBranch : "");
+}
 async function driftFix(id) {
   if (!id) die("npx plures drift fix <case id> [--app <app>]");
   const cl = client();
@@ -836,6 +854,8 @@ async function driftFix(id) {
   } catch (e) {
     return fail(e instanceof PluresError ? e.message : String(e));
   }
+  const est = await cl.maps.estimate(app, "drift", { case: id }).catch(() => null);
+  if (est?.blocked) return fail(est.blocked);
   if (!hasClaude()) return fail("Claude Code isn't installed here, so nothing could read the code.");
   const git = (...a) => (0, import_node_child_process.spawnSync)("git", a, { encoding: "utf8" });
   if (git("status", "--porcelain").stdout.trim()) return fail("This repo has changes that aren't committed. Commit or stash them first.");
@@ -843,7 +863,7 @@ async function driftFix(id) {
   const ownClaude = Boolean(process.env.ANTHROPIC_API_KEY || process.env.CLAUDE_CODE_OAUTH_TOKEN || process.env.ANTHROPIC_AUTH_TOKEN);
   if (!ownClaude && process.env.CI) {
     try {
-      const run = await cl.maps.startRun(app);
+      const run = await cl.maps.startRun(app, { purpose: "drift", case: id });
       childEnv.ANTHROPIC_BASE_URL = run.base_url;
       childEnv.ANTHROPIC_API_KEY = run.token;
     } catch (e) {

package/dist/cli.js

@@ -3,7 +3,7 @@ import {
   Plures,
   PluresError,
   VERSION
-} from "./chunk-RKIJTDS3.js";
+} from "./chunk-3P2G67SF.js";
 
 // src/cli.ts
 import { spawnSync, spawn } from "child_process";
@@ -228,8 +228,7 @@ async function upload(file) {
   }
   if (!fancy) console.log(dim(`Sending the map to Plures. No source code is sent.`));
   let m;
-  const gitBranch = spawnSync("git", ["rev-parse", "--abbrev-ref", "HEAD"], { encoding: "utf8" }).stdout?.trim();
-  const branchName = process.env.PLURES_BRANCH || process.env.GITHUB_HEAD_REF || process.env.GITHUB_REF_NAME || (gitBranch && gitBranch !== "HEAD" ? gitBranch : "");
+  const branchName = currentBranch();
   try {
     m = await client().maps.upload(app, map2, branchName ? { branch: branchName } : {});
   } catch (e) {
@@ -279,6 +278,14 @@ With plures-mcp connected, just ask: ${cyan("Map this app for Plures")}`);
     return;
   }
   const before = existsSync(FILE) ? statSync(FILE).mtimeMs : 0;
+  const est = await client().maps.estimate(app).catch(() => null);
+  if (est) {
+    const br = currentBranch();
+    const main2 = !br || br === "main" || br === "master";
+    if (est.blocked && main2) die(est.blocked);
+    if (main2 && est.engine_fee.free) console.log(dim("Plures engine: this app's first map is free."));
+    else if (main2 && est.engine_fee.cents) console.log(dim(`Plures engine: about $${(est.engine_fee.cents / 100).toFixed(2)} (${est.engine_fee.steps} steps at ${est.engine_fee.per_step_cents}\xA2), from your credit when the map uploads.`));
+  }
   const childEnv = { ...process.env };
   const ownClaude = Boolean(process.env.ANTHROPIC_API_KEY || process.env.CLAUDE_CODE_OAUTH_TOKEN || process.env.ANTHROPIC_AUTH_TOKEN);
   if (!ownClaude && (process.env.CI || argv.includes("--plures-claude"))) {
@@ -537,6 +544,10 @@ ${cyan("\u2713")} The check is on the branch ${bold(br)}. Review it with ${cyan(
     die(e instanceof PluresError ? e.message : String(e));
   }
 }
+function currentBranch() {
+  const gitBranch = spawnSync("git", ["rev-parse", "--abbrev-ref", "HEAD"], { encoding: "utf8" }).stdout?.trim();
+  return process.env.PLURES_BRANCH || process.env.GITHUB_HEAD_REF || process.env.GITHUB_REF_NAME || (gitBranch && gitBranch !== "HEAD" ? gitBranch : "");
+}
 async function driftFix(id) {
   if (!id) die("npx plures drift fix <case id> [--app <app>]");
   const cl = client();
@@ -552,6 +563,8 @@ async function driftFix(id) {
   } catch (e) {
     return fail(e instanceof PluresError ? e.message : String(e));
   }
+  const est = await cl.maps.estimate(app, "drift", { case: id }).catch(() => null);
+  if (est?.blocked) return fail(est.blocked);
   if (!hasClaude()) return fail("Claude Code isn't installed here, so nothing could read the code.");
   const git = (...a) => spawnSync("git", a, { encoding: "utf8" });
   if (git("status", "--porcelain").stdout.trim()) return fail("This repo has changes that aren't committed. Commit or stash them first.");
@@ -559,7 +572,7 @@ async function driftFix(id) {
   const ownClaude = Boolean(process.env.ANTHROPIC_API_KEY || process.env.CLAUDE_CODE_OAUTH_TOKEN || process.env.ANTHROPIC_AUTH_TOKEN);
   if (!ownClaude && process.env.CI) {
     try {
-      const run = await cl.maps.startRun(app);
+      const run = await cl.maps.startRun(app, { purpose: "drift", case: id });
       childEnv.ANTHROPIC_BASE_URL = run.base_url;
       childEnv.ANTHROPIC_API_KEY = run.token;
     } catch (e) {

package/dist/index.cjs

@@ -26,7 +26,7 @@ __export(index_exports, {
   default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
-var VERSION = "1.18.0";
+var VERSION = "1.22.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -134,8 +134,12 @@ var Plures = class {
     createKey: (app, opts = {}) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app)}/map_keys`, opts),
     keys: (app) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/map_keys`),
     revokeKey: (app, id) => this.req("DELETE", `/api/v1/apps/${encodeURIComponent(app)}/map_keys/${encodeURIComponent(id)}`),
+    /** What the next map or drift fix will cost before it starts. A map: the Plures engine fee, per step of the app's map
+     * (the first map of each app is free), and Claude at cost if Plures runs it. A drift fix: paid by outcome,
+     * drift_fix.per_point_cents for each quality point it wins back, at most drift_fix.max_cents, Claude included. blocked says why it can't start. */
+    estimate: (app, kind = "map", opts = {}) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/map_estimate?for=${kind}${opts.case ? `&case=${encodeURIComponent(opts.case)}` : ""}`),
     /** Starts a map run where Plures runs Claude (CI with no Anthropic key). npx plures map does this. */
-    startRun: (app) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app)}/map_runs`, {}),
+    startRun: (app, opts = {}) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app)}/map_runs`, opts),
     runs: (app) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/map_runs`),
     /** While mapping, which files the coding agent is reading, shown live on the map page. File names only. npx plures map does this. */
     progress: (app, p) => this.req("POST", `/api/v1/apps/${encodeURIComponent(app)}/map/progress`, p),
@@ -171,6 +175,9 @@ var Plures = class {
    * early, and compare two versions blind before you ship. Personal details are taken out first.
    */
   quality = {
+    /** Rubrics the Plures engine suggests for an app: from what graders found in its answers (source "grades", with
+     * evidence) and from its agent map (source "map", with the step and file). Add one with rubrics.create. */
+    suggestions: (app) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/rubric_suggestions`),
     /** Send every output; the rubric's sample rate decides which ones people grade. */
     sample: (p) => this.req("POST", "/api/v1/samples", p),
     /** A blind release check: a is the current version's output, b the new one's, for the same input. */

package/dist/index.d.cts

@@ -1,3 +1,48 @@
+type RubricSuggestion = {
+    object: "rubric_suggestion";
+    name: string;
+    question: string;
+    options: string[];
+    sample_rate: number;
+    why: string;
+    source: "map" | "grades";
+    evidence?: {
+        n: number;
+        examples: string[];
+    };
+    node: {
+        id: string;
+        label: string;
+        file: string | null;
+        line: number | null;
+    } | null;
+};
+type MapEstimate = {
+    object: "map_estimate";
+    app: string;
+    for: "map" | "drift";
+    engine_fee: {
+        steps: number | null;
+        cents: number | null;
+        free: boolean;
+        per_step_cents: number;
+        basis: string;
+    };
+    claude_cents_if_plures_runs: number | null;
+    /** For a drift fix: paid by outcome, per_point_cents for each quality point won back, at most max_cents. Claude included. */
+    drift_fix?: {
+        steps: number | null;
+        per_point_cents: number;
+        lost_points: number | null;
+        max_cents: number;
+        min_point_cents: number;
+        max_point_cents: number;
+        cap_cents: number;
+        outcome: true;
+        free_under_guarantee: boolean;
+    };
+    blocked: string | null;
+};
 type Option = {
     id: string;
     label: string;
@@ -480,7 +525,7 @@ type WebhookEvent = {
     created_at: string;
     data: Task;
 };
-declare const VERSION = "1.18.0";
+declare const VERSION = "1.22.0";
 type GitHubLink = {
     object: "github_link";
     app: string;
@@ -617,12 +662,22 @@ declare class Plures {
             id: string;
             deleted: true;
         }>;
+        /** What the next map or drift fix will cost before it starts. A map: the Plures engine fee, per step of the app's map
+         * (the first map of each app is free), and Claude at cost if Plures runs it. A drift fix: paid by outcome,
+         * drift_fix.per_point_cents for each quality point it wins back, at most drift_fix.max_cents, Claude included. blocked says why it can't start. */
+        estimate: (app: string, kind?: "map" | "drift", opts?: {
+            case?: string;
+        }) => Promise<MapEstimate>;
         /** Starts a map run where Plures runs Claude (CI with no Anthropic key). npx plures map does this. */
-        startRun: (app: string) => Promise<{
+        startRun: (app: string, opts?: {
+            purpose?: "map" | "drift";
+            case?: string;
+        }) => Promise<{
             object: "map_run";
             id: string;
             app: string;
             free: boolean;
+            purpose: "map" | "drift";
             max_cents: number;
             token: string;
             base_url: string;
@@ -723,6 +778,13 @@ declare class Plures {
      * early, and compare two versions blind before you ship. Personal details are taken out first.
      */
     quality: {
+        /** Rubrics the Plures engine suggests for an app: from what graders found in its answers (source "grades", with
+         * evidence) and from its agent map (source "map", with the step and file). Add one with rubrics.create. */
+        suggestions: (app: string) => Promise<{
+            object: "list";
+            app: string;
+            data: RubricSuggestion[];
+        }>;
         /** Send every output; the rubric's sample rate decides which ones people grade. */
         sample: (p: {
             rubric: string;
@@ -898,4 +960,4 @@ declare class Plures {
     static verifyWebhook(rawBody: string, signatureHeader: string | null, secret: string, toleranceSec?: number): Promise<WebhookEvent>;
 }
 
-export { type AgentMap, type App, type Balance, type CheckOverrides, type CheckResult, type Consensus, type CreateTask, type DriftCase, type DriftDiagnosis, type Escalation, type GitHubLink, type MapChanges, type MapCheckpoint, type MapDraft, type MapKey, type MapNode, type Mix, type Option, Plures, PluresError, type Release, type Result, type Route, type Routing, type RoutingRule, type RoutingUpdate, type Rubric, type RubricParams, type Sample, type StoredAgentMap, type Task, type TaskStatus, type TeamTally, type TeamVote, type TestMix, type TurnParams, VERSION, type WebhookEvent, Plures as default };
+export { type AgentMap, type App, type Balance, type CheckOverrides, type CheckResult, type Consensus, type CreateTask, type DriftCase, type DriftDiagnosis, type Escalation, type GitHubLink, type MapChanges, type MapCheckpoint, type MapDraft, type MapEstimate, type MapKey, type MapNode, type Mix, type Option, Plures, PluresError, type Release, type Result, type Route, type Routing, type RoutingRule, type RoutingUpdate, type Rubric, type RubricParams, type RubricSuggestion, type Sample, type StoredAgentMap, type Task, type TaskStatus, type TeamTally, type TeamVote, type TestMix, type TurnParams, VERSION, type WebhookEvent, Plures as default };

package/dist/index.d.ts

@@ -1,3 +1,48 @@
+type RubricSuggestion = {
+    object: "rubric_suggestion";
+    name: string;
+    question: string;
+    options: string[];
+    sample_rate: number;
+    why: string;
+    source: "map" | "grades";
+    evidence?: {
+        n: number;
+        examples: string[];
+    };
+    node: {
+        id: string;
+        label: string;
+        file: string | null;
+        line: number | null;
+    } | null;
+};
+type MapEstimate = {
+    object: "map_estimate";
+    app: string;
+    for: "map" | "drift";
+    engine_fee: {
+        steps: number | null;
+        cents: number | null;
+        free: boolean;
+        per_step_cents: number;
+        basis: string;
+    };
+    claude_cents_if_plures_runs: number | null;
+    /** For a drift fix: paid by outcome, per_point_cents for each quality point won back, at most max_cents. Claude included. */
+    drift_fix?: {
+        steps: number | null;
+        per_point_cents: number;
+        lost_points: number | null;
+        max_cents: number;
+        min_point_cents: number;
+        max_point_cents: number;
+        cap_cents: number;
+        outcome: true;
+        free_under_guarantee: boolean;
+    };
+    blocked: string | null;
+};
 type Option = {
     id: string;
     label: string;
@@ -480,7 +525,7 @@ type WebhookEvent = {
     created_at: string;
     data: Task;
 };
-declare const VERSION = "1.18.0";
+declare const VERSION = "1.22.0";
 type GitHubLink = {
     object: "github_link";
     app: string;
@@ -617,12 +662,22 @@ declare class Plures {
             id: string;
             deleted: true;
         }>;
+        /** What the next map or drift fix will cost before it starts. A map: the Plures engine fee, per step of the app's map
+         * (the first map of each app is free), and Claude at cost if Plures runs it. A drift fix: paid by outcome,
+         * drift_fix.per_point_cents for each quality point it wins back, at most drift_fix.max_cents, Claude included. blocked says why it can't start. */
+        estimate: (app: string, kind?: "map" | "drift", opts?: {
+            case?: string;
+        }) => Promise<MapEstimate>;
         /** Starts a map run where Plures runs Claude (CI with no Anthropic key). npx plures map does this. */
-        startRun: (app: string) => Promise<{
+        startRun: (app: string, opts?: {
+            purpose?: "map" | "drift";
+            case?: string;
+        }) => Promise<{
             object: "map_run";
             id: string;
             app: string;
             free: boolean;
+            purpose: "map" | "drift";
             max_cents: number;
             token: string;
             base_url: string;
@@ -723,6 +778,13 @@ declare class Plures {
      * early, and compare two versions blind before you ship. Personal details are taken out first.
      */
     quality: {
+        /** Rubrics the Plures engine suggests for an app: from what graders found in its answers (source "grades", with
+         * evidence) and from its agent map (source "map", with the step and file). Add one with rubrics.create. */
+        suggestions: (app: string) => Promise<{
+            object: "list";
+            app: string;
+            data: RubricSuggestion[];
+        }>;
         /** Send every output; the rubric's sample rate decides which ones people grade. */
         sample: (p: {
             rubric: string;
@@ -898,4 +960,4 @@ declare class Plures {
     static verifyWebhook(rawBody: string, signatureHeader: string | null, secret: string, toleranceSec?: number): Promise<WebhookEvent>;
 }
 
-export { type AgentMap, type App, type Balance, type CheckOverrides, type CheckResult, type Consensus, type CreateTask, type DriftCase, type DriftDiagnosis, type Escalation, type GitHubLink, type MapChanges, type MapCheckpoint, type MapDraft, type MapKey, type MapNode, type Mix, type Option, Plures, PluresError, type Release, type Result, type Route, type Routing, type RoutingRule, type RoutingUpdate, type Rubric, type RubricParams, type Sample, type StoredAgentMap, type Task, type TaskStatus, type TeamTally, type TeamVote, type TestMix, type TurnParams, VERSION, type WebhookEvent, Plures as default };
+export { type AgentMap, type App, type Balance, type CheckOverrides, type CheckResult, type Consensus, type CreateTask, type DriftCase, type DriftDiagnosis, type Escalation, type GitHubLink, type MapChanges, type MapCheckpoint, type MapDraft, type MapEstimate, type MapKey, type MapNode, type Mix, type Option, Plures, PluresError, type Release, type Result, type Route, type Routing, type RoutingRule, type RoutingUpdate, type Rubric, type RubricParams, type RubricSuggestion, type Sample, type StoredAgentMap, type Task, type TaskStatus, type TeamTally, type TeamVote, type TestMix, type TurnParams, VERSION, type WebhookEvent, Plures as default };

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   PluresError,
   VERSION,
   index_default
-} from "./chunk-RKIJTDS3.js";
+} from "./chunk-3P2G67SF.js";
 export {
   Plures,
   PluresError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plures",
-  "version": "1.18.0",
+  "version": "1.22.0",
   "description": "Human judgment as an API for AI agents. Send a decision to ID verified people and get their consensus back.",
   "keywords": [
     "human-in-the-loop",