plures 1.3.0 → 1.4.0

package/README.md

@@ -46,6 +46,7 @@ if (event.type === "task.completed" && event.data.result?.agreement === 1) {
 
 - `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`.
 - `plures.tasks.retrieve(id)`, `plures.tasks.list({ status?, limit?, starting_after? })`, `plures.tasks.cancel(id)`
+- `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.balance()`: your prepaid credit for live tasks, in cents. Live tasks cost $0.20 per answer (more for clips); a task that could cost more than your available credit throws a `PluresError` with `type` `insufficient_credits` (status 402).
 - `plures.tasks.waitFor(id, { timeoutMs?, intervalMs? })`: poll until settled
 - `plures.verify(params, { timeoutMs?, idempotencyKey? })`: create and wait

package/dist/index.cjs

@@ -26,7 +26,7 @@ __export(index_exports, {
   default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
-var VERSION = "1.3.0";
+var VERSION = "1.4.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -81,6 +81,17 @@ var Plures = class {
       }
     }
   };
+  /**
+   * Test keys only. How test tasks behave when they don't set metadata.test_outcome,
+   * so an agent running unchanged sends a share of decisions to your team.
+   * A single task can override it with metadata.test_mix.
+   */
+  testMix = {
+    get: () => this.req("GET", "/api/v1/test_mix"),
+    /** For example { unanimous: 70, split: 20, tie: 5, expired: 5 }. Pass null to turn it off. */
+    set: (mix) => this.req("PUT", "/api/v1/test_mix", { mix }),
+    clear: () => this.req("DELETE", "/api/v1/test_mix")
+  };
   /** Your prepaid credit. A live task that could cost more than available_cents is refused with a 402 insufficient_credits error. */
   balance = () => this.req("GET", "/api/v1/balance");
   /** Creates a task and waits for people to answer it. */

package/dist/index.d.cts

@@ -84,6 +84,18 @@ type CreateTask = {
     /** Agreement below which this task goes to your team, 0 to 1. Default from your dashboard. */
     escalate_below?: number;
 };
+/** Whole number shares of test task outcomes that add up to 100. */
+type Mix = {
+    unanimous?: number;
+    split?: number;
+    tie?: number;
+    expired?: number;
+};
+type TestMix = {
+    object: "test_mix";
+    mix: Mix | null;
+    to_team_percent: number;
+};
 /** Prepaid credit for live tasks, in US cents. */
 type Balance = {
     object: "balance";
@@ -105,7 +117,7 @@ type WebhookEvent = {
     created_at: string;
     data: Task;
 };
-declare const VERSION = "1.3.0";
+declare const VERSION = "1.4.0";
 declare class PluresError extends Error {
     readonly status: number;
     readonly type: string;
@@ -140,6 +152,17 @@ declare class Plures {
             intervalMs?: number;
         }) => Promise<Task>;
     };
+    /**
+     * Test keys only. How test tasks behave when they don't set metadata.test_outcome,
+     * so an agent running unchanged sends a share of decisions to your team.
+     * A single task can override it with metadata.test_mix.
+     */
+    testMix: {
+        get: () => Promise<TestMix>;
+        /** For example { unanimous: 70, split: 20, tie: 5, expired: 5 }. Pass null to turn it off. */
+        set: (mix: Mix | null) => Promise<TestMix>;
+        clear: () => Promise<TestMix>;
+    };
     /** Your prepaid credit. A live task that could cost more than available_cents is refused with a 402 insufficient_credits error. */
     balance: () => Promise<Balance>;
     /** Creates a task and waits for people to answer it. */
@@ -155,4 +178,4 @@ declare class Plures {
     static verifyWebhook(rawBody: string, signatureHeader: string | null, secret: string, toleranceSec?: number): Promise<WebhookEvent>;
 }
 
-export { type Balance, type CreateTask, type Escalation, type Option, Plures, PluresError, type Result, type Task, type TaskStatus, VERSION, type WebhookEvent, Plures as default };
+export { type Balance, type CreateTask, type Escalation, type Mix, type Option, Plures, PluresError, type Result, type Task, type TaskStatus, type TestMix, VERSION, type WebhookEvent, Plures as default };

package/dist/index.d.ts

@@ -84,6 +84,18 @@ type CreateTask = {
     /** Agreement below which this task goes to your team, 0 to 1. Default from your dashboard. */
     escalate_below?: number;
 };
+/** Whole number shares of test task outcomes that add up to 100. */
+type Mix = {
+    unanimous?: number;
+    split?: number;
+    tie?: number;
+    expired?: number;
+};
+type TestMix = {
+    object: "test_mix";
+    mix: Mix | null;
+    to_team_percent: number;
+};
 /** Prepaid credit for live tasks, in US cents. */
 type Balance = {
     object: "balance";
@@ -105,7 +117,7 @@ type WebhookEvent = {
     created_at: string;
     data: Task;
 };
-declare const VERSION = "1.3.0";
+declare const VERSION = "1.4.0";
 declare class PluresError extends Error {
     readonly status: number;
     readonly type: string;
@@ -140,6 +152,17 @@ declare class Plures {
             intervalMs?: number;
         }) => Promise<Task>;
     };
+    /**
+     * Test keys only. How test tasks behave when they don't set metadata.test_outcome,
+     * so an agent running unchanged sends a share of decisions to your team.
+     * A single task can override it with metadata.test_mix.
+     */
+    testMix: {
+        get: () => Promise<TestMix>;
+        /** For example { unanimous: 70, split: 20, tie: 5, expired: 5 }. Pass null to turn it off. */
+        set: (mix: Mix | null) => Promise<TestMix>;
+        clear: () => Promise<TestMix>;
+    };
     /** Your prepaid credit. A live task that could cost more than available_cents is refused with a 402 insufficient_credits error. */
     balance: () => Promise<Balance>;
     /** Creates a task and waits for people to answer it. */
@@ -155,4 +178,4 @@ declare class Plures {
     static verifyWebhook(rawBody: string, signatureHeader: string | null, secret: string, toleranceSec?: number): Promise<WebhookEvent>;
 }
 
-export { type Balance, type CreateTask, type Escalation, type Option, Plures, PluresError, type Result, type Task, type TaskStatus, VERSION, type WebhookEvent, Plures as default };
+export { type Balance, type CreateTask, type Escalation, type Mix, type Option, Plures, PluresError, type Result, type Task, type TaskStatus, type TestMix, VERSION, type WebhookEvent, Plures as default };

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-var VERSION = "1.3.0";
+var VERSION = "1.4.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);
@@ -54,6 +54,17 @@ var Plures = class {
       }
     }
   };
+  /**
+   * Test keys only. How test tasks behave when they don't set metadata.test_outcome,
+   * so an agent running unchanged sends a share of decisions to your team.
+   * A single task can override it with metadata.test_mix.
+   */
+  testMix = {
+    get: () => this.req("GET", "/api/v1/test_mix"),
+    /** For example { unanimous: 70, split: 20, tie: 5, expired: 5 }. Pass null to turn it off. */
+    set: (mix) => this.req("PUT", "/api/v1/test_mix", { mix }),
+    clear: () => this.req("DELETE", "/api/v1/test_mix")
+  };
   /** Your prepaid credit. A live task that could cost more than available_cents is refused with a 402 insufficient_credits error. */
   balance = () => this.req("GET", "/api/v1/balance");
   /** Creates a task and waits for people to answer it. */

package/package.json

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