plures 1.1.0 → 1.2.0

package/README.md

@@ -44,7 +44,7 @@ if (event.type === "task.completed" && event.data.result?.agreement === 1) {
 
 ## API
 
-- `plures.tasks.create(params, { idempotencyKey? })`: send a task. Params: `question`, `options` (2 to 8, strings or `{ id, label }`), `context`, `image_url`, `instructions`, `verifiers` (1, 3, 5, 7 or 9), `max_verifiers`, `presence_check` (default true), `webhook_url`, `metadata`, `expires_in`.
+- `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.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.1.0";
+var VERSION = "1.2.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);

package/dist/index.d.cts

@@ -32,12 +32,21 @@ type Task = {
     context: string | null;
     image_url: string | null;
     instructions: string | null;
+    audio_url?: string | null;
+    video_url?: string | null;
+    media_seconds?: number | null;
+    sensitive?: boolean;
     options: Option[];
     verifiers: number;
     presence_check?: boolean;
     result: Result | null;
     escalation?: Escalation | null;
     metadata: Record<string, unknown>;
+    /** Where this decision sits on the Plures ledger, once recorded. */
+    ledger?: {
+        seq: number;
+        url: string;
+    } | null;
     webhook_url: string | null;
     created_at: string;
     completed_at: string | null;
@@ -48,6 +57,14 @@ type CreateTask = {
     options: (string | Option)[];
     context?: string;
     image_url?: string;
+    /** A recording people play through before answering, up to 3 minutes. Needs media_seconds. */
+    audio_url?: string;
+    /** A video people play through before answering, up to 3 minutes. Needs media_seconds. Not with audio_url. */
+    video_url?: string;
+    /** The clip's length in seconds, 1 to 180. Required with audio_url or video_url; pay scales with it. */
+    media_seconds?: number;
+    /** Disturbing content: only verifiers who opted in get it, behind a warning. Default false. */
+    sensitive?: boolean;
     instructions?: string;
     verifiers?: 1 | 3 | 5 | 7 | 9;
     max_verifiers?: number;
@@ -67,7 +84,7 @@ type WebhookEvent = {
     created_at: string;
     data: Task;
 };
-declare const VERSION = "1.1.0";
+declare const VERSION = "1.2.0";
 declare class PluresError extends Error {
     readonly status: number;
     readonly type: string;

package/dist/index.d.ts

@@ -32,12 +32,21 @@ type Task = {
     context: string | null;
     image_url: string | null;
     instructions: string | null;
+    audio_url?: string | null;
+    video_url?: string | null;
+    media_seconds?: number | null;
+    sensitive?: boolean;
     options: Option[];
     verifiers: number;
     presence_check?: boolean;
     result: Result | null;
     escalation?: Escalation | null;
     metadata: Record<string, unknown>;
+    /** Where this decision sits on the Plures ledger, once recorded. */
+    ledger?: {
+        seq: number;
+        url: string;
+    } | null;
     webhook_url: string | null;
     created_at: string;
     completed_at: string | null;
@@ -48,6 +57,14 @@ type CreateTask = {
     options: (string | Option)[];
     context?: string;
     image_url?: string;
+    /** A recording people play through before answering, up to 3 minutes. Needs media_seconds. */
+    audio_url?: string;
+    /** A video people play through before answering, up to 3 minutes. Needs media_seconds. Not with audio_url. */
+    video_url?: string;
+    /** The clip's length in seconds, 1 to 180. Required with audio_url or video_url; pay scales with it. */
+    media_seconds?: number;
+    /** Disturbing content: only verifiers who opted in get it, behind a warning. Default false. */
+    sensitive?: boolean;
     instructions?: string;
     verifiers?: 1 | 3 | 5 | 7 | 9;
     max_verifiers?: number;
@@ -67,7 +84,7 @@ type WebhookEvent = {
     created_at: string;
     data: Task;
 };
-declare const VERSION = "1.1.0";
+declare const VERSION = "1.2.0";
 declare class PluresError extends Error {
     readonly status: number;
     readonly type: string;

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-var VERSION = "1.1.0";
+var VERSION = "1.2.0";
 var PluresError = class extends Error {
   constructor(message, status, type) {
     super(message);

package/package.json

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