plures 1.7.1 → 1.9.1

package/README.md

@@ -48,6 +48,7 @@ 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)`, `.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. `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.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-N4GCKRA6.js → chunk-23ZYPCPM.js}

@@ -1,5 +1,5 @@
 // src/index.ts
-var VERSION = "1.7.1";
+var VERSION = "1.9.1";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -101,7 +101,19 @@ var Plures = class {
     retrieve: (app) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/map`),
     /** Uploads a new version. Checks you already added or dismissed keep that. */
     upload: (app, map) => this.req("PUT", `/api/v1/apps/${encodeURIComponent(app)}/map`, map),
-    setCheckpoint: (app, id, status) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(app)}/map/checkpoints/${encodeURIComponent(id)}`, { status })
+    setCheckpoint: (app, id, status) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(app)}/map/checkpoints/${encodeURIComponent(id)}`, { status }),
+    /** A key that can only read and upload this app's map, for CI. The key is in the response once. */
+    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)}`),
+    /** 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`, {}),
+    runs: (app) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/map_runs`),
+    /** The GitHub Actions workflow that maps a repo on every push to its main branch. */
+    workflow: async (app, branch = "main") => {
+      const r = await fetch(`${this.base}/api/v1/map_workflow?app=${encodeURIComponent(app)}&branch=${encodeURIComponent(branch)}`);
+      return r.text();
+    }
   };
   /**
    * Quality: people grade a sample of your agent's outputs against a rubric, so you see drift

package/dist/cli.cjs

@@ -6,7 +6,7 @@ var import_node_child_process = require("child_process");
 var import_node_fs = require("fs");
 
 // src/index.ts
-var VERSION = "1.7.1";
+var VERSION = "1.9.1";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -108,7 +108,19 @@ var Plures = class {
     retrieve: (app2) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app2)}/map`),
     /** Uploads a new version. Checks you already added or dismissed keep that. */
     upload: (app2, map2) => this.req("PUT", `/api/v1/apps/${encodeURIComponent(app2)}/map`, map2),
-    setCheckpoint: (app2, id, status) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(app2)}/map/checkpoints/${encodeURIComponent(id)}`, { status })
+    setCheckpoint: (app2, id, status) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(app2)}/map/checkpoints/${encodeURIComponent(id)}`, { status }),
+    /** A key that can only read and upload this app's map, for CI. The key is in the response once. */
+    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)}`),
+    /** 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`, {}),
+    runs: (app2) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app2)}/map_runs`),
+    /** The GitHub Actions workflow that maps a repo on every push to its main branch. */
+    workflow: async (app2, branch2 = "main") => {
+      const r = await fetch(`${this.base}/api/v1/map_workflow?app=${encodeURIComponent(app2)}&branch=${encodeURIComponent(branch2)}`);
+      return r.text();
+    }
   };
   /**
    * Quality: people grade a sample of your agent's outputs against a rubric, so you see drift
@@ -181,6 +193,7 @@ var flag = (name) => {
   argv.splice(i, 2);
   return v;
 };
+var branch = flag("branch");
 var app = flag("app") ?? process.env.PLURES_APP ?? "default";
 var key = flag("key") ?? process.env.PLURES_API_KEY;
 var base = flag("base-url") ?? process.env.PLURES_BASE_URL ?? "https://plures.si";
@@ -198,7 +211,7 @@ function die(msg) {
 }
 function client() {
   if (!key) die("Set PLURES_API_KEY (a free pk_test_ key works), or pass --key. Get one at https://plures.si/?for=developers#join");
-  return new Plures(key, { baseUrl: base, app, userAgent: `plures-cli/${VERSION}` });
+  return new Plures(key, { baseUrl: base, app, userAgent: `plures-cli/${VERSION}${process.env.GITHUB_ACTIONS ? " github-actions" : ""}` });
 }
 async function upload(file) {
   if (!(0, import_node_fs.existsSync)(file)) die(`No ${file} here. Run npx plures map to make one, or pass the file's path.`);
@@ -252,19 +265,48 @@ 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;
-  console.log(`Reading this repo on your machine with Claude Code. ${dim("Only the map leaves it.")}
+  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"))) {
+    let run;
+    try {
+      run = await client().maps.startRun(app);
+    } catch (e) {
+      die(e instanceof PluresError ? e.message : String(e));
+    }
+    childEnv.ANTHROPIC_BASE_URL = run.base_url;
+    childEnv.ANTHROPIC_API_KEY = run.token;
+    console.log(dim(run.free ? "Plures is mapping this repo. Your first map is free." : `Plures is mapping this repo, at most $${(run.max_cents / 100).toFixed(2)} from your credit.`));
+  }
+  console.log(`Reading this repo ${process.env.CI ? "on this runner" : "on your machine"} with Claude Code. ${dim("Only the map is sent to Plures.")}
 `);
   const prompt = `${guide}
 
 Write the map to ${FILE} in the current directory now. Read the code; don't run it or change anything else.`;
   const code = await new Promise((resolve) => {
-    const p = (0, import_node_child_process.spawn)("claude", ["-p", prompt, "--allowedTools", "Read,Grep,Glob,Write,Bash(git rev-parse:*),Bash(git remote:*)"], { stdio: ["ignore", "inherit", "inherit"] });
+    const p = (0, import_node_child_process.spawn)("claude", ["-p", prompt, "--allowedTools", "Read,Grep,Glob,Write,Bash(git rev-parse:*),Bash(git remote:*)"], { stdio: ["ignore", "inherit", "inherit"], env: childEnv });
     p.on("close", (n) => resolve(n ?? 1));
     p.on("error", () => resolve(1));
   });
   if (code !== 0 || !(0, import_node_fs.existsSync)(FILE) || (0, import_node_fs.statSync)(FILE).mtimeMs === before) die(`Claude Code didn't write ${FILE}. Ask it directly, then run npx plures map upload.`);
   await upload(FILE);
 }
+async function workflow() {
+  const def = (0, import_node_child_process.spawnSync)("git", ["symbolic-ref", "--short", "refs/remotes/origin/HEAD"], { encoding: "utf8" }).stdout?.trim().replace(/^origin\//, "");
+  const b = branch ?? (def || "main");
+  const r = await fetch(`${base}/api/v1/map_workflow?app=${encodeURIComponent(app)}&branch=${encodeURIComponent(b)}`).catch(() => null);
+  if (!r?.ok) die("Couldn't reach Plures for the workflow. Check your connection.");
+  const path = ".github/workflows/plures-map.yml";
+  (0, import_node_fs.mkdirSync)(".github/workflows", { recursive: true });
+  (0, import_node_fs.writeFileSync)(path, await r.text());
+  console.log(`${bold("Wrote " + path)}: maps this repo on every push to ${b}.
+
+Then add two repository secrets (Settings, Secrets and variables, Actions):
+  ${cyan("PLURES_MAP_KEY")}      a map key: ${dim(`${base}/dashboard/apps/${app}/map`)} or ${dim("POST /api/v1/apps/" + app + "/map_keys")}
+  ${cyan("ANTHROPIC_API_KEY")}   or ${cyan("CLAUDE_CODE_OAUTH_TOKEN")} from ${dim("claude setup-token")}
+
+Or let Plures do all of this: ${bold("Map with GitHub")} on the app's map page.`);
+}
 async function main() {
   const [cmd, sub, arg] = argv;
   if (cmd !== "map") {
@@ -273,12 +315,14 @@ async function main() {
   npx plures map [--app <id>]          map this repo's agent and upload it
   npx plures map upload [file]         upload ${FILE}
   npx plures map guide                 print the steps for any coding agent
+  npx plures map workflow              add a GitHub Action that maps on every push
 
 Docs: https://plures.si/docs`);
     return;
   }
   if (sub === "upload") return upload(arg ?? FILE);
   if (sub === "guide") return void console.log(await (await fetch(`${base}/api/v1/map_guide`)).text());
+  if (sub === "workflow") return workflow();
   return map();
 }
 main().catch((e) => die(String(e?.message ?? e)));

package/dist/cli.js

@@ -3,11 +3,11 @@ import {
   Plures,
   PluresError,
   VERSION
-} from "./chunk-N4GCKRA6.js";
+} from "./chunk-23ZYPCPM.js";
 
 // src/cli.ts
 import { spawnSync, spawn } from "child_process";
-import { existsSync, readFileSync, statSync } from "fs";
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "fs";
 var argv = process.argv.slice(2);
 var flag = (name) => {
   const i = argv.indexOf(`--${name}`);
@@ -16,6 +16,7 @@ var flag = (name) => {
   argv.splice(i, 2);
   return v;
 };
+var branch = flag("branch");
 var app = flag("app") ?? process.env.PLURES_APP ?? "default";
 var key = flag("key") ?? process.env.PLURES_API_KEY;
 var base = flag("base-url") ?? process.env.PLURES_BASE_URL ?? "https://plures.si";
@@ -33,7 +34,7 @@ function die(msg) {
 }
 function client() {
   if (!key) die("Set PLURES_API_KEY (a free pk_test_ key works), or pass --key. Get one at https://plures.si/?for=developers#join");
-  return new Plures(key, { baseUrl: base, app, userAgent: `plures-cli/${VERSION}` });
+  return new Plures(key, { baseUrl: base, app, userAgent: `plures-cli/${VERSION}${process.env.GITHUB_ACTIONS ? " github-actions" : ""}` });
 }
 async function upload(file) {
   if (!existsSync(file)) die(`No ${file} here. Run npx plures map to make one, or pass the file's path.`);
@@ -87,19 +88,48 @@ With plures-mcp connected, just ask: ${cyan("Map this app for Plures")}`);
     return;
   }
   const before = existsSync(FILE) ? statSync(FILE).mtimeMs : 0;
-  console.log(`Reading this repo on your machine with Claude Code. ${dim("Only the map leaves it.")}
+  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"))) {
+    let run;
+    try {
+      run = await client().maps.startRun(app);
+    } catch (e) {
+      die(e instanceof PluresError ? e.message : String(e));
+    }
+    childEnv.ANTHROPIC_BASE_URL = run.base_url;
+    childEnv.ANTHROPIC_API_KEY = run.token;
+    console.log(dim(run.free ? "Plures is mapping this repo. Your first map is free." : `Plures is mapping this repo, at most $${(run.max_cents / 100).toFixed(2)} from your credit.`));
+  }
+  console.log(`Reading this repo ${process.env.CI ? "on this runner" : "on your machine"} with Claude Code. ${dim("Only the map is sent to Plures.")}
 `);
   const prompt = `${guide}
 
 Write the map to ${FILE} in the current directory now. Read the code; don't run it or change anything else.`;
   const code = await new Promise((resolve) => {
-    const p = spawn("claude", ["-p", prompt, "--allowedTools", "Read,Grep,Glob,Write,Bash(git rev-parse:*),Bash(git remote:*)"], { stdio: ["ignore", "inherit", "inherit"] });
+    const p = spawn("claude", ["-p", prompt, "--allowedTools", "Read,Grep,Glob,Write,Bash(git rev-parse:*),Bash(git remote:*)"], { stdio: ["ignore", "inherit", "inherit"], env: childEnv });
     p.on("close", (n) => resolve(n ?? 1));
     p.on("error", () => resolve(1));
   });
   if (code !== 0 || !existsSync(FILE) || statSync(FILE).mtimeMs === before) die(`Claude Code didn't write ${FILE}. Ask it directly, then run npx plures map upload.`);
   await upload(FILE);
 }
+async function workflow() {
+  const def = spawnSync("git", ["symbolic-ref", "--short", "refs/remotes/origin/HEAD"], { encoding: "utf8" }).stdout?.trim().replace(/^origin\//, "");
+  const b = branch ?? (def || "main");
+  const r = await fetch(`${base}/api/v1/map_workflow?app=${encodeURIComponent(app)}&branch=${encodeURIComponent(b)}`).catch(() => null);
+  if (!r?.ok) die("Couldn't reach Plures for the workflow. Check your connection.");
+  const path = ".github/workflows/plures-map.yml";
+  mkdirSync(".github/workflows", { recursive: true });
+  writeFileSync(path, await r.text());
+  console.log(`${bold("Wrote " + path)}: maps this repo on every push to ${b}.
+
+Then add two repository secrets (Settings, Secrets and variables, Actions):
+  ${cyan("PLURES_MAP_KEY")}      a map key: ${dim(`${base}/dashboard/apps/${app}/map`)} or ${dim("POST /api/v1/apps/" + app + "/map_keys")}
+  ${cyan("ANTHROPIC_API_KEY")}   or ${cyan("CLAUDE_CODE_OAUTH_TOKEN")} from ${dim("claude setup-token")}
+
+Or let Plures do all of this: ${bold("Map with GitHub")} on the app's map page.`);
+}
 async function main() {
   const [cmd, sub, arg] = argv;
   if (cmd !== "map") {
@@ -108,12 +138,14 @@ async function main() {
   npx plures map [--app <id>]          map this repo's agent and upload it
   npx plures map upload [file]         upload ${FILE}
   npx plures map guide                 print the steps for any coding agent
+  npx plures map workflow              add a GitHub Action that maps on every push
 
 Docs: https://plures.si/docs`);
     return;
   }
   if (sub === "upload") return upload(arg ?? FILE);
   if (sub === "guide") return void console.log(await (await fetch(`${base}/api/v1/map_guide`)).text());
+  if (sub === "workflow") return workflow();
   return map();
 }
 main().catch((e) => die(String(e?.message ?? e)));

package/dist/index.cjs

@@ -26,7 +26,7 @@ __export(index_exports, {
   default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
-var VERSION = "1.7.1";
+var VERSION = "1.9.1";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -128,7 +128,19 @@ var Plures = class {
     retrieve: (app) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/map`),
     /** Uploads a new version. Checks you already added or dismissed keep that. */
     upload: (app, map) => this.req("PUT", `/api/v1/apps/${encodeURIComponent(app)}/map`, map),
-    setCheckpoint: (app, id, status) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(app)}/map/checkpoints/${encodeURIComponent(id)}`, { status })
+    setCheckpoint: (app, id, status) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(app)}/map/checkpoints/${encodeURIComponent(id)}`, { status }),
+    /** A key that can only read and upload this app's map, for CI. The key is in the response once. */
+    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)}`),
+    /** 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`, {}),
+    runs: (app) => this.req("GET", `/api/v1/apps/${encodeURIComponent(app)}/map_runs`),
+    /** The GitHub Actions workflow that maps a repo on every push to its main branch. */
+    workflow: async (app, branch = "main") => {
+      const r = await fetch(`${this.base}/api/v1/map_workflow?app=${encodeURIComponent(app)}&branch=${encodeURIComponent(branch)}`);
+      return r.text();
+    }
   };
   /**
    * Quality: people grade a sample of your agent's outputs against a rubric, so you see drift

package/dist/index.d.cts

@@ -242,6 +242,15 @@ type AgentMap = {
     }[];
     checkpoints: MapCheckpoint[];
 };
+type MapKey = {
+    object: "map_key";
+    id: string;
+    app: string;
+    prefix: string;
+    label: string | null;
+    created_at: string;
+    last_used_at: string | null;
+};
 type StoredAgentMap = AgentMap & {
     object: "agent_map";
     app: string;
@@ -341,7 +350,7 @@ type WebhookEvent = {
     created_at: string;
     data: Task;
 };
-declare const VERSION = "1.7.1";
+declare const VERSION = "1.9.1";
 declare class PluresError extends Error {
     readonly status: number;
     readonly type: string;
@@ -437,6 +446,46 @@ declare class Plures {
         /** Uploads a new version. Checks you already added or dismissed keep that. */
         upload: (app: string, map: AgentMap) => Promise<StoredAgentMap>;
         setCheckpoint: (app: string, id: string, status: "added" | "dismissed" | "suggested") => Promise<StoredAgentMap>;
+        /** A key that can only read and upload this app's map, for CI. The key is in the response once. */
+        createKey: (app: string, opts?: {
+            label?: string;
+        }) => Promise<MapKey & {
+            key: string;
+        }>;
+        keys: (app: string) => Promise<{
+            object: "list";
+            data: MapKey[];
+        }>;
+        revokeKey: (app: string, id: string) => Promise<{
+            object: "map_key";
+            id: string;
+            deleted: true;
+        }>;
+        /** Starts a map run where Plures runs Claude (CI with no Anthropic key). npx plures map does this. */
+        startRun: (app: string) => Promise<{
+            object: "map_run";
+            id: string;
+            app: string;
+            free: boolean;
+            max_cents: number;
+            token: string;
+            base_url: string;
+            model: string;
+            expires_in: number;
+        }>;
+        runs: (app: string) => Promise<{
+            object: "list";
+            data: {
+                object: "map_run";
+                id: string;
+                status: string;
+                free: boolean;
+                charged_cents: number | null;
+                created_at: string;
+            }[];
+        }>;
+        /** The GitHub Actions workflow that maps a repo on every push to its main branch. */
+        workflow: (app: string, branch?: string) => Promise<string>;
     };
     /**
      * Quality: people grade a sample of your agent's outputs against a rubric, so you see drift
@@ -529,4 +578,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 Consensus, type CreateTask, type Escalation, type MapCheckpoint, type MapDraft, 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, VERSION, type WebhookEvent, Plures as default };
+export { type AgentMap, type App, type Balance, type Consensus, type CreateTask, type Escalation, 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, VERSION, type WebhookEvent, Plures as default };

package/dist/index.d.ts

@@ -242,6 +242,15 @@ type AgentMap = {
     }[];
     checkpoints: MapCheckpoint[];
 };
+type MapKey = {
+    object: "map_key";
+    id: string;
+    app: string;
+    prefix: string;
+    label: string | null;
+    created_at: string;
+    last_used_at: string | null;
+};
 type StoredAgentMap = AgentMap & {
     object: "agent_map";
     app: string;
@@ -341,7 +350,7 @@ type WebhookEvent = {
     created_at: string;
     data: Task;
 };
-declare const VERSION = "1.7.1";
+declare const VERSION = "1.9.1";
 declare class PluresError extends Error {
     readonly status: number;
     readonly type: string;
@@ -437,6 +446,46 @@ declare class Plures {
         /** Uploads a new version. Checks you already added or dismissed keep that. */
         upload: (app: string, map: AgentMap) => Promise<StoredAgentMap>;
         setCheckpoint: (app: string, id: string, status: "added" | "dismissed" | "suggested") => Promise<StoredAgentMap>;
+        /** A key that can only read and upload this app's map, for CI. The key is in the response once. */
+        createKey: (app: string, opts?: {
+            label?: string;
+        }) => Promise<MapKey & {
+            key: string;
+        }>;
+        keys: (app: string) => Promise<{
+            object: "list";
+            data: MapKey[];
+        }>;
+        revokeKey: (app: string, id: string) => Promise<{
+            object: "map_key";
+            id: string;
+            deleted: true;
+        }>;
+        /** Starts a map run where Plures runs Claude (CI with no Anthropic key). npx plures map does this. */
+        startRun: (app: string) => Promise<{
+            object: "map_run";
+            id: string;
+            app: string;
+            free: boolean;
+            max_cents: number;
+            token: string;
+            base_url: string;
+            model: string;
+            expires_in: number;
+        }>;
+        runs: (app: string) => Promise<{
+            object: "list";
+            data: {
+                object: "map_run";
+                id: string;
+                status: string;
+                free: boolean;
+                charged_cents: number | null;
+                created_at: string;
+            }[];
+        }>;
+        /** The GitHub Actions workflow that maps a repo on every push to its main branch. */
+        workflow: (app: string, branch?: string) => Promise<string>;
     };
     /**
      * Quality: people grade a sample of your agent's outputs against a rubric, so you see drift
@@ -529,4 +578,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 Consensus, type CreateTask, type Escalation, type MapCheckpoint, type MapDraft, 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, VERSION, type WebhookEvent, Plures as default };
+export { type AgentMap, type App, type Balance, type Consensus, type CreateTask, type Escalation, 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, VERSION, type WebhookEvent, Plures as default };

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plures",
-  "version": "1.7.1",
+  "version": "1.9.1",
   "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",