plures 1.22.0 → 1.23.0

package/README.md

@@ -45,12 +45,12 @@ if (event.type === "task.completed" && event.data.result?.agreement === 1) {
 ## API
 
 - `plures.check(id, data, overrides?)`: run a check from your app's map, one line before the action it guards: `const check = await plures.check("refunds", { order_total, reason }); if (check.answer !== "Approve") return`. The check saved on Plures supplies the question, options, which fields people see (the rest come back in `kept_private`), who decides, how often, its conditions and what happens on a timeout, so you change them on Plures, not in code. `checked` says whether a person looked; `skipped_because` says why not. Overrides: `question`, `options`, `verifiers`, `team`, `route`, `sample`, `timeout`, `always`.
-- `plures.turns.log({ question, answer, intent, rerouted_to, retrieval, sources, session, channel })`: answer reviews for assistants. Send each turn after it's answered (don't await it in the user's path); Plures picks the ones that went wrong (rerouted, refused, empty, no sources, asked again) plus a few at random, and your team grades them. `plures.turns.insights(app)` and `plures.turns.export(app, "routes" | "retrieval" | "qa" | "missed")` turn the grades into routing examples and eval sets.
+- `plures.turns.log({ question, answer, intent, rerouted_to, retrieval, sources, session, channel })`: answer reviews for assistants. Send each turn after it's answered (don't await it in the user's path); Plures picks the ones that went wrong (rerouted, refused, empty, no sources, asked again) plus a few at random, and your team grades them. `plures.turns.insights(app)` and `plures.turns.export(app, "routes" | "qa" | "missed")` turn the grades into routing examples and eval sets.
 - `plures.drift.list(app)`, `.fix(app, id)`: drift cases, when a rubric or an answer intent's grades fall. `npx plures drift fix <case> --app <app>` has Claude Code read the repo with the graded examples that got worse, find the cause, fix it and add eval cases; on GitHub, Plures opens the pull request and then checks the grades come back.
 - `npx plures check add <id> --app <app>`: Claude Code puts that line before the action on a new branch. On GitHub (the dashboard's **Add it to my code**) Plures then opens a pull request.
 - `plures.tasks.create(params, { idempotencyKey? })`: send a task. Params: `question`, `options` (2 to 8, strings or `{ id, label }`), `context`, `image_url`, `audio_url` or `video_url` with `media_seconds` (a clip up to 180 seconds that people play through before answering), `sensitive`, `instructions`, `verifiers` (1, 3, 5, 7 or 9), `max_verifiers`, `presence_check` (default true), `webhook_url`, `metadata`, `expires_in`, `route` (`"team"` sends it straight to your own people, $0.05 per internal vote live), `category` (matches your routing rules) and `team` (one of your named teams), `team_votes` and `team_unanimous` (internal consensus: how many of your team vote, and whether they must all agree; a split goes to the team's lead).
 - `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.
+- `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?, archived? })`, `.archive(id)`, `.restore(id)`, `.del(id)`. An archived app keeps its history but takes no new work. 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 (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.

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

@@ -1,5 +1,5 @@
 // src/index.ts
-var VERSION = "1.22.0";
+var VERSION = "1.23.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -84,9 +84,13 @@ var Plures = class {
     /** { name: "Support agent" }, with an optional id like "support-agent". */
     create: (params) => this.req("POST", "/api/v1/apps", params),
     retrieve: (id) => this.req("GET", `/api/v1/apps/${encodeURIComponent(id)}`),
-    /** Rename it, change its id (its tasks move with it), or make it the default. */
+    /** Rename it, change its id (its tasks move with it), make it the default, or archive and restore it. */
     update: (id, params) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(id)}`, params),
-    /** Only an app with no tasks can be deleted. */
+    /** Keeps its tasks, ledger, map and grades readable, but it takes no new work and doesn't count toward the 25 app limit. */
+    archive: (id) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(id)}`, { archived: true }),
+    /** Brings an archived app back into use. */
+    restore: (id) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(id)}`, { archived: false }),
+    /** Only an app with no tasks can be deleted; archive one that has them. */
     del: (id) => this.req("DELETE", `/api/v1/apps/${encodeURIComponent(id)}`)
   };
   /**
@@ -188,7 +192,7 @@ var Plures = class {
     grade: (id, g) => this.req("POST", `/api/v1/turns/${encodeURIComponent(id)}/grade`, g),
     /** What the grades say: per intent, misroutes, retrieval misses and missed asks. */
     insights: (app, opts = {}) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/turns/insights${opts.days ? `?days=${opts.days}` : ""}`),
-    /** Graded turns as eval data: routes (routing examples), retrieval ({ query, doc, must_contain }), qa ({ question, fact } or { question, unanswerable }), missed. */
+    /** Graded turns as eval data: routes (routing examples), qa ({ question, must_cover, sources_only } or { question, unanswerable: true }), missed. */
     export: async (app, kind, opts = {}) => {
       const q = new URLSearchParams({ kind, ...opts.since ? { since: opts.since } : {} });
       const r = await fetch(`${this.base}/api/v1/apps/${encodeURIComponent(app)}/turns/export?${q}`, { headers: { authorization: `Bearer ${this.apiKey}`, "user-agent": this.ua } });

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.22.0";
+var VERSION = "1.23.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -115,9 +115,13 @@ var Plures = class {
     /** { name: "Support agent" }, with an optional id like "support-agent". */
     create: (params) => this.req("POST", "/api/v1/apps", params),
     retrieve: (id) => this.req("GET", `/api/v1/apps/${encodeURIComponent(id)}`),
-    /** Rename it, change its id (its tasks move with it), or make it the default. */
+    /** Rename it, change its id (its tasks move with it), make it the default, or archive and restore it. */
     update: (id, params) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(id)}`, params),
-    /** Only an app with no tasks can be deleted. */
+    /** Keeps its tasks, ledger, map and grades readable, but it takes no new work and doesn't count toward the 25 app limit. */
+    archive: (id) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(id)}`, { archived: true }),
+    /** Brings an archived app back into use. */
+    restore: (id) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(id)}`, { archived: false }),
+    /** Only an app with no tasks can be deleted; archive one that has them. */
     del: (id) => this.req("DELETE", `/api/v1/apps/${encodeURIComponent(id)}`)
   };
   /**
@@ -219,7 +223,7 @@ var Plures = class {
     grade: (id, g) => this.req("POST", `/api/v1/turns/${encodeURIComponent(id)}/grade`, g),
     /** What the grades say: per intent, misroutes, retrieval misses and missed asks. */
     insights: (app2, opts = {}) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app2)}/turns/insights${opts.days ? `?days=${opts.days}` : ""}`),
-    /** Graded turns as eval data: routes (routing examples), retrieval ({ query, doc, must_contain }), qa ({ question, fact } or { question, unanswerable }), missed. */
+    /** Graded turns as eval data: routes (routing examples), qa ({ question, must_cover, sources_only } or { question, unanswerable: true }), missed. */
     export: async (app2, kind, opts = {}) => {
       const q = new URLSearchParams({ kind, ...opts.since ? { since: opts.since } : {} });
       const r = await fetch(`${this.base}/api/v1/apps/${encodeURIComponent(app2)}/turns/export?${q}`, { headers: { authorization: `Bearer ${this.apiKey}`, "user-agent": this.ua } });

package/dist/cli.js

@@ -3,7 +3,7 @@ import {
   Plures,
   PluresError,
   VERSION
-} from "./chunk-3P2G67SF.js";
+} from "./chunk-VATZXULP.js";
 
 // src/cli.ts
 import { spawnSync, spawn } from "child_process";

package/dist/index.cjs

@@ -26,7 +26,7 @@ __export(index_exports, {
   default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
-var VERSION = "1.22.0";
+var VERSION = "1.23.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -111,9 +111,13 @@ var Plures = class {
     /** { name: "Support agent" }, with an optional id like "support-agent". */
     create: (params) => this.req("POST", "/api/v1/apps", params),
     retrieve: (id) => this.req("GET", `/api/v1/apps/${encodeURIComponent(id)}`),
-    /** Rename it, change its id (its tasks move with it), or make it the default. */
+    /** Rename it, change its id (its tasks move with it), make it the default, or archive and restore it. */
     update: (id, params) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(id)}`, params),
-    /** Only an app with no tasks can be deleted. */
+    /** Keeps its tasks, ledger, map and grades readable, but it takes no new work and doesn't count toward the 25 app limit. */
+    archive: (id) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(id)}`, { archived: true }),
+    /** Brings an archived app back into use. */
+    restore: (id) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(id)}`, { archived: false }),
+    /** Only an app with no tasks can be deleted; archive one that has them. */
     del: (id) => this.req("DELETE", `/api/v1/apps/${encodeURIComponent(id)}`)
   };
   /**
@@ -215,7 +219,7 @@ var Plures = class {
     grade: (id, g) => this.req("POST", `/api/v1/turns/${encodeURIComponent(id)}/grade`, g),
     /** What the grades say: per intent, misroutes, retrieval misses and missed asks. */
     insights: (app, opts = {}) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/turns/insights${opts.days ? `?days=${opts.days}` : ""}`),
-    /** Graded turns as eval data: routes (routing examples), retrieval ({ query, doc, must_contain }), qa ({ question, fact } or { question, unanswerable }), missed. */
+    /** Graded turns as eval data: routes (routing examples), qa ({ question, must_cover, sources_only } or { question, unanswerable: true }), missed. */
     export: async (app, kind, opts = {}) => {
       const q = new URLSearchParams({ kind, ...opts.since ? { since: opts.since } : {} });
       const r = await fetch(`${this.base}/api/v1/apps/${encodeURIComponent(app)}/turns/export?${q}`, { headers: { authorization: `Bearer ${this.apiKey}`, "user-agent": this.ua } });

package/dist/index.d.cts

@@ -499,7 +499,8 @@ type App = {
     object: "app";
     id: string;
     name: string;
-    default: boolean;
+    default: boolean; /** Keeps its history but takes no new work. */
+    archived: boolean;
     created_at: string;
     tasks_30d?: number;
     waiting?: number;
@@ -525,7 +526,7 @@ type WebhookEvent = {
     created_at: string;
     data: Task;
 };
-declare const VERSION = "1.22.0";
+declare const VERSION = "1.23.0";
 type GitHubLink = {
     object: "github_link";
     app: string;
@@ -621,13 +622,18 @@ declare class Plures {
             id?: string;
         }) => Promise<App>;
         retrieve: (id: string) => Promise<App>;
-        /** Rename it, change its id (its tasks move with it), or make it the default. */
+        /** Rename it, change its id (its tasks move with it), make it the default, or archive and restore it. */
         update: (id: string, params: {
             name?: string;
             id?: string;
             default?: true;
+            archived?: boolean;
         }) => Promise<App>;
-        /** Only an app with no tasks can be deleted. */
+        /** Keeps its tasks, ledger, map and grades readable, but it takes no new work and doesn't count toward the 25 app limit. */
+        archive: (id: string) => Promise<App>;
+        /** Brings an archived app back into use. */
+        restore: (id: string) => Promise<App>;
+        /** Only an app with no tasks can be deleted; archive one that has them. */
         del: (id: string) => Promise<{
             object: "app";
             id: string;
@@ -891,8 +897,8 @@ declare class Plures {
         insights: (app: string, opts?: {
             days?: number;
         }) => Promise<Record<string, unknown>>;
-        /** Graded turns as eval data: routes (routing examples), retrieval ({ query, doc, must_contain }), qa ({ question, fact } or { question, unanswerable }), missed. */
-        export: (app: string, kind: "routes" | "retrieval" | "qa" | "missed", opts?: {
+        /** Graded turns as eval data: routes (routing examples), qa ({ question, must_cover, sources_only } or { question, unanswerable: true }), missed. */
+        export: (app: string, kind: "routes" | "qa" | "missed", opts?: {
             since?: string;
         }) => Promise<Record<string, unknown>[]>;
     };

package/dist/index.d.ts

@@ -499,7 +499,8 @@ type App = {
     object: "app";
     id: string;
     name: string;
-    default: boolean;
+    default: boolean; /** Keeps its history but takes no new work. */
+    archived: boolean;
     created_at: string;
     tasks_30d?: number;
     waiting?: number;
@@ -525,7 +526,7 @@ type WebhookEvent = {
     created_at: string;
     data: Task;
 };
-declare const VERSION = "1.22.0";
+declare const VERSION = "1.23.0";
 type GitHubLink = {
     object: "github_link";
     app: string;
@@ -621,13 +622,18 @@ declare class Plures {
             id?: string;
         }) => Promise<App>;
         retrieve: (id: string) => Promise<App>;
-        /** Rename it, change its id (its tasks move with it), or make it the default. */
+        /** Rename it, change its id (its tasks move with it), make it the default, or archive and restore it. */
         update: (id: string, params: {
             name?: string;
             id?: string;
             default?: true;
+            archived?: boolean;
         }) => Promise<App>;
-        /** Only an app with no tasks can be deleted. */
+        /** Keeps its tasks, ledger, map and grades readable, but it takes no new work and doesn't count toward the 25 app limit. */
+        archive: (id: string) => Promise<App>;
+        /** Brings an archived app back into use. */
+        restore: (id: string) => Promise<App>;
+        /** Only an app with no tasks can be deleted; archive one that has them. */
         del: (id: string) => Promise<{
             object: "app";
             id: string;
@@ -891,8 +897,8 @@ declare class Plures {
         insights: (app: string, opts?: {
             days?: number;
         }) => Promise<Record<string, unknown>>;
-        /** Graded turns as eval data: routes (routing examples), retrieval ({ query, doc, must_contain }), qa ({ question, fact } or { question, unanswerable }), missed. */
-        export: (app: string, kind: "routes" | "retrieval" | "qa" | "missed", opts?: {
+        /** Graded turns as eval data: routes (routing examples), qa ({ question, must_cover, sources_only } or { question, unanswerable: true }), missed. */
+        export: (app: string, kind: "routes" | "qa" | "missed", opts?: {
             since?: string;
         }) => Promise<Record<string, unknown>[]>;
     };

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plures",
-  "version": "1.22.0",
+  "version": "1.23.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",