plures 1.7.1 → 1.10.0

package/dist/chunk-N4GCKRA6.js

@@ -1,174 +0,0 @@
-// src/index.ts
-var VERSION = "1.7.1";
-var PluresError = class extends Error {
-  constructor(message, status, type) {
-    super(message);
-    this.status = status;
-    this.type = type;
-  }
-  status;
-  type;
-};
-var Plures = class {
-  base;
-  apiKey;
-  /** The app tasks go to when they don't name one. From opts.app or PLURES_APP. */
-  app;
-  ua;
-  constructor(apiKey, opts = {}) {
-    const key = apiKey ?? (typeof process !== "undefined" ? process.env?.PLURES_API_KEY : void 0);
-    if (!key) throw new Error("Pass your Plures API key, or set PLURES_API_KEY. Get a free test key at https://plures.si/?for=developers#join");
-    this.apiKey = key;
-    this.ua = opts.userAgent ?? `plures-js/${VERSION}`;
-    this.app = opts.app ?? (typeof process !== "undefined" ? process.env?.PLURES_APP : void 0) ?? null;
-    this.base = (opts.baseUrl ?? (typeof process !== "undefined" ? process.env?.PLURES_BASE_URL : void 0) ?? "https://plures.si").replace(/\/$/, "");
-  }
-  async req(method, path, body, headers = {}) {
-    for (let attempt = 0; ; attempt++) {
-      const r = await fetch(this.base + path, {
-        method,
-        headers: { authorization: `Bearer ${this.apiKey}`, "user-agent": this.ua, ...body ? { "content-type": "application/json" } : {}, ...this.app ? { "plures-app": this.app } : {}, ...headers },
-        body: body ? JSON.stringify(body) : void 0
-      });
-      if (r.status >= 500 && attempt < 2) {
-        await sleep(500 * 2 ** attempt);
-        continue;
-      }
-      const data = await r.json().catch(() => ({}));
-      if (!r.ok) throw new PluresError(data?.error?.message ?? `HTTP ${r.status}`, r.status, data?.error?.type ?? "api_error");
-      return data;
-    }
-  }
-  tasks = {
-    /** Sends a question to verified people. Pass an idempotency key to make retries safe. */
-    create: (params, opts = {}) => this.req("POST", "/api/v1/tasks", params, opts.idempotencyKey ? { "idempotency-key": opts.idempotencyKey } : {}),
-    retrieve: (id) => this.req("GET", `/api/v1/tasks/${encodeURIComponent(id)}`),
-    list: (params = {}) => {
-      const q = new URLSearchParams(Object.entries(params).filter(([, v]) => v != null).map(([k, v]) => [k, String(v)]));
-      return this.req("GET", `/api/v1/tasks${q.size ? `?${q}` : ""}`);
-    },
-    cancel: (id) => this.req("POST", `/api/v1/tasks/${encodeURIComponent(id)}/cancel`),
-    /** Polls until the task is settled. Prefer webhooks in production. */
-    waitFor: async (id, opts = {}) => {
-      const end = Date.now() + (opts.timeoutMs ?? 10 * 6e4);
-      for (; ; ) {
-        const t = await this.tasks.retrieve(id);
-        if (t.status !== "pending") return t;
-        if (Date.now() > end) return t;
-        await sleep(opts.intervalMs ?? 3e3);
-      }
-    }
-  };
-  /**
-   * 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")
-  };
-  /**
-   * Where tasks go. set() replaces what you send (team, groups or rules) and keeps the rest.
-   * For example { groups: [{ name: "Finance", emails: ["ap@acme.com"] }], rules: [{ category: "refunds", route: "team", group: "Finance" }] }.
-   */
-  routing = {
-    get: () => this.req("GET", "/api/v1/routing"),
-    set: (update) => this.req("PUT", "/api/v1/routing", update)
-  };
-  /** Your apps. Each agent you run can be its own app, with its own tasks, ledger view and map. */
-  apps = {
-    list: () => this.req("GET", "/api/v1/apps"),
-    /** { 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. */
-    update: (id, params) => this.req("PATCH", `/api/v1/apps/${encodeURIComponent(id)}`, params),
-    /** Only an app with no tasks can be deleted. */
-    del: (id) => this.req("DELETE", `/api/v1/apps/${encodeURIComponent(id)}`)
-  };
-  /**
-   * Agent maps: where each app's agent needs a person. Your coding agent reads your code and
-   * writes the map; Plures gets only the map. guide() returns the steps it follows.
-   */
-  maps = {
-    guide: async () => {
-      const r = await fetch(`${this.base}/api/v1/map_guide`);
-      return r.text();
-    },
-    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 })
-  };
-  /**
-   * Quality: people grade a sample of your agent's outputs against a rubric, so you see drift
-   * early, and compare two versions blind before you ship. Personal details are taken out first.
-   */
-  quality = {
-    /** 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. */
-    compare: (p) => this.req("POST", "/api/v1/comparisons", p),
-    /** How often people preferred the new version, with a 95% range and a verdict. */
-    release: (name, opts = {}) => this.req("GET", `/api/v1/releases/${encodeURIComponent(name)}${opts.app ? `?app=${encodeURIComponent(opts.app)}` : ""}`),
-    rubrics: {
-      list: (opts = {}) => this.req("GET", `/api/v1/rubrics${opts.app ? `?app=${encodeURIComponent(opts.app)}` : ""}`),
-      /** { name: "reply_quality", question: "Is this reply correct and kind?", options: ["Good", "Okay", "Bad"], sample_rate: 0.05 } */
-      create: (p) => this.req("POST", "/api/v1/rubrics", p),
-      retrieve: (name, opts = {}) => this.req("GET", `/api/v1/rubrics/${encodeURIComponent(name)}${opts.app ? `?app=${encodeURIComponent(opts.app)}` : ""}`),
-      update: (name, p) => this.req("PATCH", `/api/v1/rubrics/${encodeURIComponent(name)}${p.app ? `?app=${encodeURIComponent(p.app)}` : ""}`, p),
-      del: (name, opts = {}) => this.req("DELETE", `/api/v1/rubrics/${encodeURIComponent(name)}${opts.app ? `?app=${encodeURIComponent(opts.app)}` : ""}`)
-    },
-    /** Graded samples as JSON lines (input, output, grade, score, agreement), for fine tuning or an eval set. */
-    export: async (rubric, opts = {}) => {
-      const q = new URLSearchParams(Object.entries({ app: opts.app ?? this.app ?? void 0, since: opts.since }).filter(([, v]) => v));
-      const r = await fetch(`${this.base}/api/v1/rubrics/${encodeURIComponent(rubric)}/export${q.size ? `?${q}` : ""}`, { headers: { authorization: `Bearer ${this.apiKey}`, "user-agent": this.ua } });
-      if (!r.ok) {
-        const d = await r.json().catch(() => ({}));
-        throw new PluresError(d?.error?.message ?? `HTTP ${r.status}`, r.status, d?.error?.type ?? "api_error");
-      }
-      return (await r.text()).split("\n").filter(Boolean).map((l) => JSON.parse(l));
-    }
-  };
-  /** 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. */
-  async verify(params, opts = {}) {
-    const t = await this.tasks.create(params, { idempotencyKey: opts.idempotencyKey });
-    return t.status === "pending" ? this.tasks.waitFor(t.id, { timeoutMs: opts.timeoutMs }) : t;
-  }
-  /**
-   * Checks the Plures-Signature header on a webhook and returns the parsed event.
-   * Pass the raw request body exactly as received. Throws if the signature is wrong
-   * or older than toleranceSec.
-   */
-  static async verifyWebhook(rawBody, signatureHeader, secret, toleranceSec = 300) {
-    const parts = Object.fromEntries((signatureHeader ?? "").split(",").map((p) => p.split("=", 2)));
-    const t = Number(parts.t);
-    if (!t || !parts.v1) throw new Error("Missing Plures-Signature header");
-    if (Math.abs(Date.now() / 1e3 - t) > toleranceSec) throw new Error("Webhook timestamp is too old");
-    const key = await crypto.subtle.importKey("raw", new TextEncoder().encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
-    const mac = new Uint8Array(await crypto.subtle.sign("HMAC", key, new TextEncoder().encode(`${t}.${rawBody}`)));
-    const expected = Array.from(mac, (b) => b.toString(16).padStart(2, "0")).join("");
-    if (!timingSafeEqual(expected, parts.v1)) throw new Error("Webhook signature does not match");
-    return JSON.parse(rawBody);
-  }
-};
-function timingSafeEqual(a, b) {
-  if (a.length !== b.length) return false;
-  let diff = 0;
-  for (let i = 0; i < a.length; i++) diff |= a.charCodeAt(i) ^ b.charCodeAt(i);
-  return diff === 0;
-}
-var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-var index_default = Plures;
-
-export {
-  VERSION,
-  PluresError,
-  Plures,
-  index_default
-};