@verdict-ai/sdk 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Verdict contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,22 @@
-# Temporary Holding Version
+# @verdict-ai/sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Typed HTTP client for the Verdict REST API.
+
+```bash
+npm install @verdict-ai/sdk
+```
+
+```ts
+import { Verdict } from "@verdict-ai/sdk";
+const verdict = new Verdict({ baseUrl: "http://localhost:8787" });
+const rubric = await verdict.rubrics.create({
+  name: "Presence", criteria: [{ id: "present", name: "Has text",
+    judge: { type: "benchmark", method: "length", min: 1 } }],
+});
+const evaluation = await verdict.evaluations.create({
+  rubric: rubric.id, inputs: [{ type: "text", text: "Hello Verdict" }],
+});
+console.log(evaluation.aggregate.score);
+```
+
+Requires Node 20 or newer. [Documentation](https://verdict-docs.developerolim.workers.dev/reference/sdk). MIT licensed.

package/dist/environment.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Reads which rubric versions an environment runs, for a service that evaluates on its own machine with its own model
+ * keys (docs/design/control-plane.md §6). The whole environment arrives in one answer and is kept; after `refreshMs`
+ * the next call asks the server again — no timer runs, so this works in Workers. A check that fails or is slow never
+ * stops the service: it carries on with the versions it holds and says so in `source`.
+ */
+import type { Rubric, RubricInput } from "@verdict-ai/core";
+export interface EnvironmentOptions {
+    project: string;
+    environment: string;
+    /** How long an answer is used before the next call asks the server again. Default 60 s. */
+    refreshMs?: number;
+    /** How long a check may take before the versions already held are used instead. Default 2 s. */
+    timeoutMs?: number;
+    /** Rubrics to run, by name, while the server has given none: at a cold start it cannot answer, or before a first promotion. */
+    fallback?: Record<string, RubricInput>;
+    /** Told about every failed check. The reader carries on with what it holds. */
+    onError?: (error: unknown) => void;
+    /** Clock (tests). */
+    now?: () => number;
+}
+export interface EnvironmentRubric {
+    rubric: Rubric;
+    /** The version that will run — log it with each judgment. */
+    versionId: string;
+    /** `server`: confirmed by the last check. `stale`: the last check failed, this is what was held. `fallback`: the rubric given in code. */
+    source: "server" | "stale" | "fallback";
+}
+export interface EnvironmentReader {
+    /** The rubric this environment runs under `name`. Throws only when there is nothing to run: no answer yet and no fallback. */
+    rubric(name: string): Promise<EnvironmentRubric>;
+    /** Asks the server now, whatever `refreshMs` says. Resolves to whether the check succeeded. */
+    refresh(): Promise<boolean>;
+}
+/** GET `path` with these headers, giving up after `timeoutMs`. */
+export type EnvironmentTransport = (path: string, headers: Record<string, string>, timeoutMs: number) => Promise<Response>;
+export declare function environmentReader(send: EnvironmentTransport, options: EnvironmentOptions): EnvironmentReader;

package/dist/environment.js

@@ -0,0 +1,76 @@
+import { VerdictError } from "./errors.js";
+const DEFAULT_REFRESH_MS = 60_000;
+const DEFAULT_TIMEOUT_MS = 2_000;
+/** Freezes a document the way the server does; loaded on first use so clients that never read environments stay small. */
+async function freeze(rubric) {
+    const { freezeRubric } = await import("@verdict-ai/core");
+    const version = await freezeRubric(rubric);
+    return { rubric: version.rubric, versionId: version.id };
+}
+/** Every document is used only if it freezes to the id the server named: a changed or cut-off answer is refused whole. */
+async function verified(answer) {
+    const kept = new Map();
+    for (const pointer of answer.pointers ?? []) {
+        const frozen = await freeze(pointer.rubric);
+        if (frozen.versionId !== pointer.versionId)
+            throw new VerdictError(502, "integrity", `${pointer.name}: the server named ${pointer.versionId}, but the rubric it sent freezes to ${frozen.versionId}`);
+        kept.set(pointer.name, frozen);
+    }
+    return kept;
+}
+async function failure(res) {
+    const body = await res.json().catch(() => undefined);
+    return new VerdictError(res.status, body?.error?.type ?? "http", body?.error?.message ?? `HTTP ${res.status}`);
+}
+export function environmentReader(send, options) {
+    const { project, environment, refreshMs = DEFAULT_REFRESH_MS, timeoutMs = DEFAULT_TIMEOUT_MS, fallback = {}, onError, now = () => Date.now() } = options;
+    const path = `/v1/projects/${encodeURIComponent(project)}/environments/${encodeURIComponent(environment)}?include=rubrics`;
+    const spares = new Map();
+    let held;
+    let checkedAt = Number.NEGATIVE_INFINITY, confirmed = false, lastError, checking;
+    const check = async () => {
+        try {
+            const res = await send(path, held?.etag ? { "if-none-match": held.etag } : {}, timeoutMs);
+            if (!(res.status === 304 && held)) {
+                if (!res.ok)
+                    throw await failure(res);
+                held = { etag: res.headers.get("etag"), rubrics: await verified(await res.json()) };
+            }
+            confirmed = true;
+        }
+        catch (error) {
+            confirmed = false;
+            lastError = error;
+            onError?.(error);
+        }
+        finally {
+            checkedAt = now();
+        }
+    };
+    // Calls that arrive during a check wait for that one check.
+    const checked = () => (checking ??= check().finally(() => { checking = undefined; }));
+    const spare = (name) => (name in fallback ? spares.get(name) ?? spares.set(name, freeze(fallback[name])).get(name) : undefined);
+    return {
+        async rubric(name) {
+            // With nothing to run for this name, waiting out the interval would only delay the error.
+            const nothingToRun = !held && !(name in fallback);
+            if (now() - checkedAt >= refreshMs || nothingToRun)
+                await checked();
+            const kept = held?.rubrics.get(name);
+            if (kept)
+                return { ...kept, source: confirmed ? "server" : "stale" };
+            const given = await spare(name);
+            if (given)
+                return { ...given, source: "fallback" };
+            if (held)
+                throw new VerdictError(404, "not_promoted", `${environment} in ${project} does not run ${name}, and no fallback rubric was given for it`);
+            const why = lastError instanceof Error ? lastError.message : String(lastError);
+            throw new VerdictError(lastError instanceof VerdictError ? lastError.status : 0, "environment_unavailable", `could not read ${environment} in ${project} and no fallback rubric was given for ${name}: ${why}`);
+        },
+        async refresh() {
+            await checked();
+            return confirmed;
+        },
+    };
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAsC3C,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAEjC,0HAA0H;AAC1H,KAAK,UAAU,MAAM,CAAC,MAAe;IACnC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;AAC3D,CAAC;AAED,0HAA0H;AAC1H,KAAK,UAAU,QAAQ,CAAC,MAAc;IACpC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAgB,CAAC;IACrC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS;YAAE,MAAM,IAAI,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,sBAAsB,OAAO,CAAC,SAAS,uCAAuC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACtM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,GAAa;IAClC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAgE,CAAC;IACpH,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;AACjH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAA0B,EAAE,OAA2B;IACvF,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,GAAG,kBAAkB,EAAE,SAAS,GAAG,kBAAkB,EAAE,QAAQ,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IACzJ,MAAM,IAAI,GAAG,gBAAgB,kBAAkB,CAAC,OAAO,CAAC,iBAAiB,kBAAkB,CAAC,WAAW,CAAC,kBAAkB,CAAC;IAC3H,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAChD,IAAI,IAAqE,CAAC;IAC1E,IAAI,SAAS,GAAG,MAAM,CAAC,iBAAiB,EAAE,SAAS,GAAG,KAAK,EAAE,SAAkB,EAAE,QAAmC,CAAC;IAErH,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YAC1F,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,GAAG,CAAC,EAAE;oBAAE,MAAM,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;gBACtC,IAAI,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,EAAY,CAAC,EAAE,CAAC;YAChG,CAAC;YACD,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,SAAS,GAAG,KAAK,CAAC;YAClB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;gBAAS,CAAC;YAAC,SAAS,GAAG,GAAG,EAAE,CAAC;QAAC,CAAC;IAClC,CAAC,CAAC;IACF,4DAA4D;IAC5D,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtF,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEzI,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,IAAI;YACf,0FAA0F;YAC1F,MAAM,YAAY,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC;YAClD,IAAI,GAAG,EAAE,GAAG,SAAS,IAAI,SAAS,IAAI,YAAY;gBAAE,MAAM,OAAO,EAAE,CAAC;YACpE,MAAM,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,IAAI;gBAAE,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACrE,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,KAAK;gBAAE,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;YACnD,IAAI,IAAI;gBAAE,MAAM,IAAI,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,WAAW,OAAO,OAAO,iBAAiB,IAAI,2CAA2C,CAAC,CAAC;YACpJ,MAAM,GAAG,GAAG,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/E,MAAM,IAAI,YAAY,CAAC,SAAS,YAAY,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,yBAAyB,EAAE,kBAAkB,WAAW,OAAO,OAAO,yCAAyC,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC;QAClN,CAAC;QACD,KAAK,CAAC,OAAO;YACX,MAAM,OAAO,EAAE,CAAC;YAChB,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Carries transport status, error type and optional API issues for failed client requests. `details` is the API's
+ * whole error object: a refused promotion (`type: "pointer_conflict"`) lists where the pointers are in `details.current`.
+ */
+export declare class VerdictError extends Error {
+    status: number;
+    type: string;
+    issues?: unknown | undefined;
+    details?: Record<string, unknown> | undefined;
+    constructor(status: number, type: string, message: string, issues?: unknown | undefined, details?: Record<string, unknown> | undefined);
+}

package/dist/errors.js

@@ -0,0 +1,18 @@
+/**
+ * Carries transport status, error type and optional API issues for failed client requests. `details` is the API's
+ * whole error object: a refused promotion (`type: "pointer_conflict"`) lists where the pointers are in `details.current`.
+ */
+export class VerdictError extends Error {
+    status;
+    type;
+    issues;
+    details;
+    constructor(status, type, message, issues, details) {
+        super(message);
+        this.status = status;
+        this.type = type;
+        this.issues = issues;
+        this.details = details;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAClB;IAAuB;IAAsC;IAAyB;IAAzG,YAAmB,MAAc,EAAS,IAAY,EAAE,OAAe,EAAS,MAAgB,EAAS,OAAiC;QAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAA1I,WAAM,GAAN,MAAM,CAAQ;QAAS,SAAI,GAAJ,IAAI,CAAQ;QAA0B,WAAM,GAAN,MAAM,CAAU;QAAS,YAAO,GAAP,OAAO,CAA0B;IAAoB,CAAC;CAChK"}

package/dist/index.d.ts

@@ -0,0 +1,602 @@
+/**
+ * Provides a typed client for Verdict REST operations and polling.
+ * Idempotency replay metadata is preserved; transport failures use VerdictError and Workers-safe fetch.
+ */
+import type { CalibrationReport, Aggregation, ComparisonReport, ComparisonReportRequest, Environment, Evaluation, Input, Pointer, Project, ProjectVersion, PromotionEvent, PromotionRequest, Publication, PublicationIssue, PublicationRequest, PublicationResult, PublicListing, PublicPublication, PublicVersionEntry, RollbackRequest, Rubric, RubricInput, RubricName, RunReport, RunReportRequest, Subject, VersionUpload } from "@verdict-ai/core";
+import { type EnvironmentOptions, type EnvironmentReader } from "./environment.js";
+export { VerdictError } from "./errors.js";
+export type { EnvironmentOptions, EnvironmentReader, EnvironmentRubric } from "./environment.js";
+export interface VerdictOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    /** Request timeout in ms (sync evaluations can take a while). Default 10 min. */
+    timeoutMs?: number;
+    /** The organisation requests are about, on servers where one key reaches several (sent as `x-verdict-org`). Other servers ignore it. */
+    org?: string;
+}
+/** How a server signs people in from the CLI when it runs the approval itself. */
+export interface BrowserSignIn {
+    kind: "browser";
+    start: string;
+    token: string;
+}
+/** Documents as the control plane returns them: without the tenant they are stored under. */
+export type ProjectView = Omit<Project, "tenantId">;
+export type EnvironmentView = Omit<Environment, "tenantId">;
+export type PointerView = Pick<Pointer, "name" | "versionId" | "updatedAt">;
+export type VersionView = Omit<ProjectVersion, "tenantId">;
+export type PromotionEventView = Omit<PromotionEvent, "tenantId">;
+export type RunReportView = Omit<RunReport, "tenantId">;
+export type ComparisonReportView = Omit<ComparisonReport, "tenantId">;
+export interface EvaluateParams {
+    rubric: string | RubricInput;
+    inputs?: Input[];
+    subject?: Subject;
+    name?: string;
+    metadata?: Record<string, unknown>;
+    webhook?: string;
+    includeEvidence?: boolean;
+}
+export type EvaluationView = Omit<Evaluation, "rubric" | "evidence"> & {
+    rubric: Pick<Rubric, "id" | "name" | "version" | "aggregation">;
+    evidence: Array<Record<string, unknown>>;
+};
+/**
+ * Verdict client — mirrors the REST API 1:1.
+ *
+ *   const verdict = new Verdict({ apiKey: "sk_..." });
+ *   const ev = await verdict.evaluations.create({ rubric: "rub_123", inputs: [{ type: "url", url: "https://..." }] });
+ *   console.log(ev.aggregate.score, ev.aggregate.grade);
+ */
+export declare class Verdict {
+    private apiKey?;
+    private baseUrl;
+    private f;
+    private timeoutMs;
+    private org;
+    constructor(opts?: VerdictOptions);
+    request<T>(method: string, path: string, body?: unknown, contentType?: string, headers?: Record<string, string>): Promise<T>;
+    requestWithMeta<T>(method: string, path: string, body?: unknown, contentType?: string, headers?: Record<string, string>): Promise<{
+        data: T;
+        replayed: boolean;
+    }>;
+    /**
+     * What an environment runs, for a service that evaluates locally: `await verdict.environment({ project, environment }).rubric("intent")`
+     * resolves to `{ rubric, versionId, source }`. Keep one reader per environment: it holds the versions it received and
+     * asks the server again only after `refreshMs`.
+     */
+    environment(options: EnvironmentOptions): EnvironmentReader;
+    /** A GET that gives up after `timeoutMs`, whether or not the fetch in use honours the abort signal. */
+    private get;
+    rubrics: {
+        calibration: (id: string, options?: {
+            target?: number;
+            buckets?: number;
+            limit?: number;
+        }) => Promise<CalibrationReport>;
+        create: (rubric: RubricInput | string) => Promise<{
+            name: string;
+            version: string;
+            scale: {
+                type: "numeric";
+                min: number;
+                max: number;
+                step?: number | undefined;
+            } | {
+                type: "binary";
+                labels?: [string, string] | undefined;
+            } | {
+                type: "ordinal";
+                labels: string[];
+                values?: number[] | undefined;
+            };
+            judges: Record<string, import("@verdict-ai/core").JudgeSpec>;
+            defaultJudge: import("@verdict-ai/core").JudgeSpec;
+            criteria: {
+                id: string;
+                name: string;
+                weight: number;
+                optional: boolean;
+                description?: string | undefined;
+                scale?: {
+                    type: "numeric";
+                    min: number;
+                    max: number;
+                    step?: number | undefined;
+                } | {
+                    type: "binary";
+                    labels?: [string, string] | undefined;
+                } | {
+                    type: "ordinal";
+                    labels: string[];
+                    values?: number[] | undefined;
+                } | undefined;
+                anchors?: Record<string, string> | undefined;
+                choices?: Record<string, string> | undefined;
+                values?: Record<string, number> | undefined;
+                levels?: {
+                    value: number;
+                    description: string;
+                    label?: string | undefined;
+                }[] | undefined;
+                threshold?: number | undefined;
+                judge?: import("@verdict-ai/core").JudgeSpec | import("@verdict-ai/core").JudgeSpec[] | undefined;
+                rater?: "min" | "max" | "mean" | "median" | "majority" | "trimmed_mean" | undefined;
+                inputs?: string[] | undefined;
+                group?: string | undefined;
+            }[];
+            aggregation: {
+                method: "min" | "max" | "formula" | "mean" | "median" | "weighted_mean" | "weighted_sum" | "geometric_mean";
+                rater: "min" | "max" | "mean" | "median" | "majority" | "trimmed_mean";
+                normalize: false | [number, number];
+                missing: "fail" | "exclude" | "zero";
+                gates: {
+                    criterion: string;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    message?: string | undefined;
+                }[];
+                precision: number;
+                formula?: string | undefined;
+                grades?: {
+                    label: string;
+                    min: number;
+                }[] | undefined;
+                passThreshold?: number | undefined;
+            };
+            id?: string | undefined;
+            description?: string | undefined;
+            context?: string | undefined;
+            language?: string | undefined;
+            checks?: {
+                id: string;
+                question: string;
+                expect: boolean;
+                threshold: number;
+                action: "abort" | "fail" | "flag";
+                criteria?: {
+                    true: string;
+                    false: string;
+                } | undefined;
+                message?: string | undefined;
+            }[] | undefined;
+            checksJudge?: import("@verdict-ai/core").JudgeSpec | undefined;
+            inputSchema?: import("@verdict-ai/core").InputSchema | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        } & {
+            id: string;
+        }>;
+        validate: (rubric: RubricInput | string) => Promise<{
+            valid: boolean;
+            rubric?: Rubric;
+            error?: unknown;
+        }>;
+        get: (id: string) => Promise<{
+            name: string;
+            version: string;
+            scale: {
+                type: "numeric";
+                min: number;
+                max: number;
+                step?: number | undefined;
+            } | {
+                type: "binary";
+                labels?: [string, string] | undefined;
+            } | {
+                type: "ordinal";
+                labels: string[];
+                values?: number[] | undefined;
+            };
+            judges: Record<string, import("@verdict-ai/core").JudgeSpec>;
+            defaultJudge: import("@verdict-ai/core").JudgeSpec;
+            criteria: {
+                id: string;
+                name: string;
+                weight: number;
+                optional: boolean;
+                description?: string | undefined;
+                scale?: {
+                    type: "numeric";
+                    min: number;
+                    max: number;
+                    step?: number | undefined;
+                } | {
+                    type: "binary";
+                    labels?: [string, string] | undefined;
+                } | {
+                    type: "ordinal";
+                    labels: string[];
+                    values?: number[] | undefined;
+                } | undefined;
+                anchors?: Record<string, string> | undefined;
+                choices?: Record<string, string> | undefined;
+                values?: Record<string, number> | undefined;
+                levels?: {
+                    value: number;
+                    description: string;
+                    label?: string | undefined;
+                }[] | undefined;
+                threshold?: number | undefined;
+                judge?: import("@verdict-ai/core").JudgeSpec | import("@verdict-ai/core").JudgeSpec[] | undefined;
+                rater?: "min" | "max" | "mean" | "median" | "majority" | "trimmed_mean" | undefined;
+                inputs?: string[] | undefined;
+                group?: string | undefined;
+            }[];
+            aggregation: {
+                method: "min" | "max" | "formula" | "mean" | "median" | "weighted_mean" | "weighted_sum" | "geometric_mean";
+                rater: "min" | "max" | "mean" | "median" | "majority" | "trimmed_mean";
+                normalize: false | [number, number];
+                missing: "fail" | "exclude" | "zero";
+                gates: {
+                    criterion: string;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    message?: string | undefined;
+                }[];
+                precision: number;
+                formula?: string | undefined;
+                grades?: {
+                    label: string;
+                    min: number;
+                }[] | undefined;
+                passThreshold?: number | undefined;
+            };
+            id?: string | undefined;
+            description?: string | undefined;
+            context?: string | undefined;
+            language?: string | undefined;
+            checks?: {
+                id: string;
+                question: string;
+                expect: boolean;
+                threshold: number;
+                action: "abort" | "fail" | "flag";
+                criteria?: {
+                    true: string;
+                    false: string;
+                } | undefined;
+                message?: string | undefined;
+            }[] | undefined;
+            checksJudge?: import("@verdict-ai/core").JudgeSpec | undefined;
+            inputSchema?: import("@verdict-ai/core").InputSchema | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        } & {
+            id: string;
+        }>;
+        list: () => Promise<{
+            data: Array<Rubric & {
+                id: string;
+            }>;
+        }>;
+        update: (id: string, rubric: RubricInput) => Promise<{
+            name: string;
+            version: string;
+            scale: {
+                type: "numeric";
+                min: number;
+                max: number;
+                step?: number | undefined;
+            } | {
+                type: "binary";
+                labels?: [string, string] | undefined;
+            } | {
+                type: "ordinal";
+                labels: string[];
+                values?: number[] | undefined;
+            };
+            judges: Record<string, import("@verdict-ai/core").JudgeSpec>;
+            defaultJudge: import("@verdict-ai/core").JudgeSpec;
+            criteria: {
+                id: string;
+                name: string;
+                weight: number;
+                optional: boolean;
+                description?: string | undefined;
+                scale?: {
+                    type: "numeric";
+                    min: number;
+                    max: number;
+                    step?: number | undefined;
+                } | {
+                    type: "binary";
+                    labels?: [string, string] | undefined;
+                } | {
+                    type: "ordinal";
+                    labels: string[];
+                    values?: number[] | undefined;
+                } | undefined;
+                anchors?: Record<string, string> | undefined;
+                choices?: Record<string, string> | undefined;
+                values?: Record<string, number> | undefined;
+                levels?: {
+                    value: number;
+                    description: string;
+                    label?: string | undefined;
+                }[] | undefined;
+                threshold?: number | undefined;
+                judge?: import("@verdict-ai/core").JudgeSpec | import("@verdict-ai/core").JudgeSpec[] | undefined;
+                rater?: "min" | "max" | "mean" | "median" | "majority" | "trimmed_mean" | undefined;
+                inputs?: string[] | undefined;
+                group?: string | undefined;
+            }[];
+            aggregation: {
+                method: "min" | "max" | "formula" | "mean" | "median" | "weighted_mean" | "weighted_sum" | "geometric_mean";
+                rater: "min" | "max" | "mean" | "median" | "majority" | "trimmed_mean";
+                normalize: false | [number, number];
+                missing: "fail" | "exclude" | "zero";
+                gates: {
+                    criterion: string;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    message?: string | undefined;
+                }[];
+                precision: number;
+                formula?: string | undefined;
+                grades?: {
+                    label: string;
+                    min: number;
+                }[] | undefined;
+                passThreshold?: number | undefined;
+            };
+            id?: string | undefined;
+            description?: string | undefined;
+            context?: string | undefined;
+            language?: string | undefined;
+            checks?: {
+                id: string;
+                question: string;
+                expect: boolean;
+                threshold: number;
+                action: "abort" | "fail" | "flag";
+                criteria?: {
+                    true: string;
+                    false: string;
+                } | undefined;
+                message?: string | undefined;
+            }[] | undefined;
+            checksJudge?: import("@verdict-ai/core").JudgeSpec | undefined;
+            inputSchema?: import("@verdict-ai/core").InputSchema | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        } & {
+            id: string;
+        }>;
+        delete: (id: string) => Promise<void>;
+    };
+    evaluations: {
+        retry: (id: string) => Promise<{
+            id: string;
+            status: "queued";
+            url: string;
+        }>;
+        create: (params: EvaluateParams, opts?: {
+            idempotencyKey?: string;
+        }) => Promise<EvaluationView>;
+        createIdempotent: (params: EvaluateParams, key: string) => Promise<{
+            evaluation: EvaluationView;
+            replayed: boolean;
+        }>;
+        /** Returns {id,status:"queued"}; poll with `get`, or use a webhook. */
+        createAsync: (params: EvaluateParams, opts?: {
+            idempotencyKey?: string;
+        }) => Promise<{
+            id: string;
+            status: string;
+            url: string;
+        }>;
+        get: (id: string, opts?: {
+            evidence?: boolean;
+        }) => Promise<EvaluationView>;
+        list: (q?: {
+            rubric?: string;
+            status?: string;
+            limit?: number;
+        }) => Promise<{
+            data: EvaluationView[];
+        }>;
+        submitScore: (id: string, s: {
+            criterionId: string;
+            raterId: string;
+            score: number | string;
+            rationale?: string;
+            confidence?: number;
+        }) => Promise<EvaluationView>;
+        reaggregate: (id: string, aggregation: Partial<Aggregation>, persist?: boolean) => Promise<EvaluationView>;
+        /** Poll until the evaluation leaves running/queued (does not wait for humans unless `waitForHumans`). */
+        wait: (id: string, opts?: {
+            intervalMs?: number;
+            waitForHumans?: boolean;
+            timeoutMs?: number;
+        }) => Promise<EvaluationView>;
+    };
+    tasks: {
+        list: (rater?: string) => Promise<{
+            data: Array<{
+                evaluationId: string;
+                criterionId: string;
+                raterId?: string;
+                allowedRaters?: string[];
+                instructions?: string;
+                rubric: string;
+                subject?: string;
+            }>;
+        }>;
+    };
+    /** Hub sign-in: trade a GitHub token (device flow, run by the caller) for a hub API key bound to that account. */
+    hub: {
+        config: () => Promise<{
+            github: {
+                clientId: string;
+            } | null;
+            publishing: "github" | "tenant";
+            signIn?: BrowserSignIn;
+        }>;
+        login: (githubToken: string) => Promise<{
+            apiKey: string;
+            keyId: string;
+            handle: string;
+            tenantId: string;
+        }>;
+        me: () => Promise<{
+            tenantId: string | null;
+            handle: string | null;
+            github: {
+                id: number;
+                login: string;
+            } | null;
+        }>;
+        revokeKey: (id: string) => Promise<void>;
+        /** Public reads (no key): search cards, read one card at a version with its history, or one publication by id. */
+        search: (q?: {
+            q?: string;
+            domain?: string;
+            locale?: string;
+            type?: "score" | "noul" | "choice";
+            owner?: string;
+            limit?: number;
+        }) => Promise<{
+            data: PublicListing[];
+        }>;
+        card: (owner: string, slug: string, opts?: {
+            version?: string;
+        }) => Promise<{
+            publication: PublicPublication;
+            versions: PublicVersionEntry[];
+        }>;
+        publication: (id: string) => Promise<PublicPublication>;
+    };
+    /** Publishing to the public hub: preview shows exactly the document publish would store. */
+    publications: {
+        preview: (request: PublicationRequest) => Promise<PublicationResult>;
+        create: (request: PublicationRequest) => Promise<{
+            publication: Publication;
+            warnings: PublicationIssue[];
+            created: boolean;
+        }>;
+        list: (opts?: {
+            limit?: number;
+        }) => Promise<{
+            data: Publication[];
+        }>;
+        withdraw: (id: string) => Promise<void>;
+    };
+    /** Projects group environments and rubric versions (the control plane). Deleting repeats the name as confirmation. */
+    projects: {
+        create: (name: string) => Promise<ProjectView>;
+        list: () => Promise<{
+            data: ProjectView[];
+        }>;
+        delete: (name: string) => Promise<void>;
+        /** Pointer changes of a project, newest first. */
+        history: (project: string, q?: {
+            environment?: string;
+            name?: string;
+            limit?: number;
+        }) => Promise<{
+            data: PromotionEventView[];
+        }>;
+    };
+    /** Environments say which version of each rubric runs. A change names the version the caller saw (`expected`). */
+    environments: {
+        create: (project: string, name: string) => Promise<EnvironmentView>;
+        list: (project: string) => Promise<{
+            data: EnvironmentView[];
+        }>;
+        get: (project: string, name: string) => Promise<EnvironmentView & {
+            pointers: PointerView[];
+        }>;
+        delete: (project: string, name: string) => Promise<void>;
+        /** Moves pointers, all or none. `versionId: null` removes a pointer. A stale `expected` throws `pointer_conflict`. */
+        promote: (project: string, name: string, request: PromotionRequest) => Promise<{
+            events: PromotionEventView[];
+        }>;
+        /** Undoes the latest change of one pointer. */
+        rollback: (project: string, name: string, request: RollbackRequest) => Promise<{
+            event: PromotionEventView;
+        }>;
+    };
+    /** Immutable rubric versions kept in a project under the name services ask for. */
+    versions: {
+        names: (project: string) => Promise<{
+            data: RubricName[];
+        }>;
+        /** Uploads a frozen version; the server freezes the rubric again and refuses another id. */
+        push: (project: string, name: string, version: VersionUpload) => Promise<{
+            version: VersionView;
+            created: boolean;
+        }>;
+        list: (project: string, name: string, opts?: {
+            limit?: number;
+        }) => Promise<{
+            data: Array<Omit<VersionView, "rubric">>;
+        }>;
+        get: (project: string, name: string, id: string) => Promise<VersionView>;
+        /** Refused with `in_use` while an environment points at the version. */
+        delete: (project: string, name: string, id: string) => Promise<void>;
+    };
+    /** Numbers about runs made elsewhere (your CI). Build requests with `runReportRequest` / `comparisonReportRequest` from core: they copy counts only. */
+    reports: {
+        run: (project: string, request: RunReportRequest) => Promise<{
+            report: RunReportView;
+            created: boolean;
+        }>;
+        runs: (project: string, q?: {
+            name?: string;
+            versionId?: string;
+            dataset?: string;
+            limit?: number;
+        }) => Promise<{
+            data: RunReportView[];
+        }>;
+        getRun: (project: string, runId: string) => Promise<RunReportView>;
+        /** Both runs must have been reported first. */
+        comparison: (project: string, request: ComparisonReportRequest) => Promise<{
+            report: ComparisonReportView;
+            created: boolean;
+        }>;
+        comparisons: (project: string, q?: {
+            name?: string;
+            head?: string;
+            limit?: number;
+        }) => Promise<{
+            data: ComparisonReportView[];
+        }>;
+    };
+    batches: {
+        create: (params: BatchParams, opts?: {
+            idempotencyKey?: string;
+        }) => Promise<BatchResult>;
+        createIdempotent: (params: BatchParams, key: string) => Promise<{
+            replayed: boolean;
+            ranking: Array<{
+                rank: number;
+                evaluationId: string;
+                subject: string;
+                score?: number;
+                grade?: string;
+                passed?: boolean;
+                status: string;
+            }>;
+            evaluations: EvaluationView[];
+        }>;
+    };
+}
+export default Verdict;
+export interface BatchParams {
+    rubric: string | RubricInput;
+    subjects: Subject[];
+    metadata?: Record<string, unknown>;
+    webhook?: string;
+}
+export interface BatchResult {
+    ranking: Array<{
+        rank: number;
+        evaluationId: string;
+        subject: string;
+        score?: number;
+        grade?: string;
+        passed?: boolean;
+        status: string;
+    }>;
+    evaluations: EvaluationView[];
+}

package/dist/index.js

@@ -0,0 +1,215 @@
+import { environmentReader } from "./environment.js";
+import { VerdictError } from "./errors.js";
+export { VerdictError } from "./errors.js";
+// why: synchronous judging can be slow; polling uses the same ten-minute default as individual requests.
+const DEFAULT_TIMEOUT_MS = 600_000;
+const DEFAULT_POLL_INTERVAL_MS = 1500;
+/**
+ * Verdict client — mirrors the REST API 1:1.
+ *
+ *   const verdict = new Verdict({ apiKey: "sk_..." });
+ *   const ev = await verdict.evaluations.create({ rubric: "rub_123", inputs: [{ type: "url", url: "https://..." }] });
+ *   console.log(ev.aggregate.score, ev.aggregate.grade);
+ */
+export class Verdict {
+    apiKey;
+    baseUrl;
+    f;
+    timeoutMs;
+    org;
+    constructor(opts = {}) {
+        this.org = opts.org ? { "x-verdict-org": opts.org } : {};
+        this.apiKey = opts.apiKey ?? globalThis.process?.env?.VERDICT_API_KEY;
+        this.baseUrl = (opts.baseUrl ?? globalThis.process?.env?.VERDICT_API_URL ?? "http://localhost:8787").replace(/\/$/, "");
+        this.f = opts.fetch ?? ((input, init) => globalThis.fetch(input, init)); // bound call: Workers reject a detached fetch
+        this.timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    }
+    async request(method, path, body, contentType = "application/json", headers) {
+        return (await this.requestWithMeta(method, path, body, contentType, headers)).data;
+    }
+    async requestWithMeta(method, path, body, contentType = "application/json", headers) {
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), this.timeoutMs);
+        try {
+            const res = await this.f(`${this.baseUrl}${path}`, {
+                method,
+                signal: ctrl.signal,
+                headers: { "content-type": contentType, ...(this.apiKey ? { authorization: `Bearer ${this.apiKey}` } : {}), ...this.org, ...headers },
+                body: body === undefined ? undefined : typeof body === "string" ? body : JSON.stringify(body),
+            });
+            // why: successful deletes have no JSON body to decode.
+            if (res.status === 204)
+                return { data: undefined, replayed: res.headers.get("Idempotency-Replayed") === "true" };
+            const data = await responseBody(res);
+            const error = apiError(data);
+            // The API returns failed evaluations with 422; these documents remain readable client results.
+            if (!res.ok && !(res.status === 422 && !error))
+                throw new VerdictError(res.status, error?.type ?? "http", error?.message ?? `HTTP ${res.status}`, error?.issues, error?.details);
+            return { data: data, replayed: res.headers.get("Idempotency-Replayed") === "true" };
+        }
+        catch (error) {
+            if (error instanceof VerdictError)
+                throw error;
+            throw new VerdictError(0, "network", `Verdict request failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        finally {
+            clearTimeout(t);
+        }
+    }
+    /**
+     * What an environment runs, for a service that evaluates locally: `await verdict.environment({ project, environment }).rubric("intent")`
+     * resolves to `{ rubric, versionId, source }`. Keep one reader per environment: it holds the versions it received and
+     * asks the server again only after `refreshMs`.
+     */
+    environment(options) {
+        return environmentReader((path, headers, timeoutMs) => this.get(path, headers, timeoutMs), options);
+    }
+    /** A GET that gives up after `timeoutMs`, whether or not the fetch in use honours the abort signal. */
+    async get(path, headers, timeoutMs) {
+        const ctrl = new AbortController();
+        let timer;
+        const late = new Promise((_, reject) => { timer = setTimeout(() => { ctrl.abort(); reject(new VerdictError(408, "timeout", `no answer from ${this.baseUrl} within ${timeoutMs} ms`)); }, timeoutMs); });
+        const asked = this.f(`${this.baseUrl}${path}`, { method: "GET", signal: ctrl.signal, headers: { ...(this.apiKey ? { authorization: `Bearer ${this.apiKey}` } : {}), ...this.org, ...headers } });
+        // An abort also rejects the fetch; that rejection has been answered by `late` already.
+        asked.catch(() => undefined);
+        try {
+            return await Promise.race([asked, late]);
+        }
+        catch (error) {
+            throw error instanceof VerdictError ? error : new VerdictError(0, "network", `Verdict request failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    rubrics = {
+        calibration: (id, options = {}) => this.request("GET", `/v1/rubrics/${encodeURIComponent(id)}/calibration?${new URLSearchParams(Object.entries(options).filter(([, v]) => v !== undefined).map(([k, v]) => [k, String(v)]))}`),
+        create: (rubric) => typeof rubric === "string" ? this.request("POST", "/v1/rubrics", rubric, "application/yaml") : this.request("POST", "/v1/rubrics", rubric),
+        validate: (rubric) => this.request("POST", "/v1/rubrics/validate", rubric, typeof rubric === "string" ? "application/yaml" : "application/json"),
+        get: (id) => this.request("GET", `/v1/rubrics/${id}`),
+        list: () => this.request("GET", "/v1/rubrics"),
+        update: (id, rubric) => this.request("PUT", `/v1/rubrics/${id}`, rubric),
+        delete: (id) => this.request("DELETE", `/v1/rubrics/${id}`),
+    };
+    evaluations = {
+        retry: (id) => this.request("POST", `/v1/evaluations/${encodeURIComponent(id)}/retry`),
+        create: (params, opts = {}) => this.request("POST", "/v1/evaluations", params, "application/json", keyHeaders(opts.idempotencyKey)),
+        createIdempotent: async (params, key) => {
+            const { data: evaluation, replayed } = await this.requestWithMeta("POST", "/v1/evaluations", params, "application/json", keyHeaders(key));
+            return { evaluation, replayed };
+        },
+        /** Returns {id,status:"queued"}; poll with `get`, or use a webhook. */
+        createAsync: (params, opts = {}) => this.request("POST", "/v1/evaluations", { ...params, async: true }, "application/json", keyHeaders(opts.idempotencyKey)),
+        get: (id, opts = {}) => this.request("GET", `/v1/evaluations/${id}${opts.evidence ? "?evidence=true" : ""}`),
+        list: (q = {}) => this.request("GET", `/v1/evaluations?${new URLSearchParams(Object.entries(q).filter(([, v]) => v !== undefined).map(([k, v]) => [k, String(v)]))}`),
+        submitScore: (id, s) => this.request("POST", `/v1/evaluations/${id}/scores`, s),
+        reaggregate: (id, aggregation, persist = false) => this.request("POST", `/v1/evaluations/${id}/aggregate`, { aggregation, persist }),
+        /** Poll until the evaluation leaves running/queued (does not wait for humans unless `waitForHumans`). */
+        wait: async (id, opts = {}) => {
+            const start = Date.now();
+            for (;;) {
+                const ev = await this.evaluations.get(id);
+                // why: human review can be unbounded, so polling stops at that state unless explicitly requested.
+                const settled = ev.status === "completed" || ev.status === "failed" || (ev.status === "pending_human" && !opts.waitForHumans);
+                if (settled)
+                    return ev;
+                if (Date.now() - start > (opts.timeoutMs ?? DEFAULT_TIMEOUT_MS))
+                    throw new VerdictError(408, "timeout", `evaluation ${id} still ${ev.status}`);
+                await new Promise((r) => setTimeout(r, opts.intervalMs ?? DEFAULT_POLL_INTERVAL_MS));
+            }
+        },
+    };
+    tasks = {
+        list: (rater) => this.request("GET", `/v1/tasks${rater ? `?rater=${encodeURIComponent(rater)}` : ""}`),
+    };
+    /** Hub sign-in: trade a GitHub token (device flow, run by the caller) for a hub API key bound to that account. */
+    hub = {
+        config: () => this.request("GET", "/v1/hub/config"),
+        login: (githubToken) => this.request("POST", "/v1/hub/login", { githubToken }),
+        me: () => this.request("GET", "/v1/hub/me"),
+        revokeKey: (id) => this.request("DELETE", `/v1/hub/keys/${encodeURIComponent(id)}`),
+        /** Public reads (no key): search cards, read one card at a version with its history, or one publication by id. */
+        search: (q = {}) => this.request("GET", `/v1/public/rubrics?${new URLSearchParams(Object.entries(q).filter(([, v]) => v !== undefined).map(([k, v]) => [k, String(v)]))}`),
+        card: (owner, slug, opts = {}) => this.request("GET", `/v1/public/rubrics/${encodeURIComponent(owner)}/${encodeURIComponent(slug)}${opts.version ? `?version=${encodeURIComponent(opts.version)}` : ""}`),
+        publication: (id) => this.request("GET", `/v1/public/publications/${encodeURIComponent(id)}`),
+    };
+    /** Publishing to the public hub: preview shows exactly the document publish would store. */
+    publications = {
+        preview: (request) => this.request("POST", "/v1/publications/preview", request),
+        create: (request) => this.request("POST", "/v1/publications", request),
+        list: (opts = {}) => this.request("GET", `/v1/publications${opts.limit ? `?limit=${opts.limit}` : ""}`),
+        withdraw: (id) => this.request("DELETE", `/v1/publications/${encodeURIComponent(id)}`),
+    };
+    /** Projects group environments and rubric versions (the control plane). Deleting repeats the name as confirmation. */
+    projects = {
+        create: (name) => this.request("POST", "/v1/projects", { name }),
+        list: () => this.request("GET", "/v1/projects"),
+        delete: (name) => this.request("DELETE", `/v1/projects/${seg(name)}`, { confirm: name }),
+        /** Pointer changes of a project, newest first. */
+        history: (project, q = {}) => this.request("GET", `/v1/projects/${seg(project)}/history${query(q)}`),
+    };
+    /** Environments say which version of each rubric runs. A change names the version the caller saw (`expected`). */
+    environments = {
+        create: (project, name) => this.request("POST", `/v1/projects/${seg(project)}/environments`, { name }),
+        list: (project) => this.request("GET", `/v1/projects/${seg(project)}/environments`),
+        get: (project, name) => this.request("GET", `/v1/projects/${seg(project)}/environments/${seg(name)}`),
+        delete: (project, name) => this.request("DELETE", `/v1/projects/${seg(project)}/environments/${seg(name)}`, { confirm: name }),
+        /** Moves pointers, all or none. `versionId: null` removes a pointer. A stale `expected` throws `pointer_conflict`. */
+        promote: (project, name, request) => this.request("POST", `/v1/projects/${seg(project)}/environments/${seg(name)}/promotions`, request),
+        /** Undoes the latest change of one pointer. */
+        rollback: (project, name, request) => this.request("POST", `/v1/projects/${seg(project)}/environments/${seg(name)}/rollbacks`, request),
+    };
+    /** Immutable rubric versions kept in a project under the name services ask for. */
+    versions = {
+        names: (project) => this.request("GET", `/v1/projects/${seg(project)}/rubrics`),
+        /** Uploads a frozen version; the server freezes the rubric again and refuses another id. */
+        push: (project, name, version) => this.request("POST", `/v1/projects/${seg(project)}/rubrics/${seg(name)}/versions`, version),
+        list: (project, name, opts = {}) => this.request("GET", `/v1/projects/${seg(project)}/rubrics/${seg(name)}/versions${query(opts)}`),
+        get: (project, name, id) => this.request("GET", `/v1/projects/${seg(project)}/rubrics/${seg(name)}/versions/${seg(id)}`),
+        /** Refused with `in_use` while an environment points at the version. */
+        delete: (project, name, id) => this.request("DELETE", `/v1/projects/${seg(project)}/rubrics/${seg(name)}/versions/${seg(id)}`),
+    };
+    /** Numbers about runs made elsewhere (your CI). Build requests with `runReportRequest` / `comparisonReportRequest` from core: they copy counts only. */
+    reports = {
+        run: (project, request) => this.request("POST", `/v1/projects/${seg(project)}/reports/runs`, request),
+        runs: (project, q = {}) => this.request("GET", `/v1/projects/${seg(project)}/reports/runs${query(q)}`),
+        getRun: (project, runId) => this.request("GET", `/v1/projects/${seg(project)}/reports/runs/${seg(runId)}`),
+        /** Both runs must have been reported first. */
+        comparison: (project, request) => this.request("POST", `/v1/projects/${seg(project)}/reports/comparisons`, request),
+        comparisons: (project, q = {}) => this.request("GET", `/v1/projects/${seg(project)}/reports/comparisons${query(q)}`),
+    };
+    batches = {
+        create: (params, opts = {}) => this.request("POST", "/v1/batches", params, "application/json", keyHeaders(opts.idempotencyKey)),
+        createIdempotent: async (params, key) => {
+            const { data, replayed } = await this.requestWithMeta("POST", "/v1/batches", params, "application/json", keyHeaders(key));
+            return { ...data, replayed };
+        },
+    };
+}
+export default Verdict;
+const seg = encodeURIComponent;
+function query(q) {
+    const entries = Object.entries(q).filter(([, v]) => v !== undefined).map(([k, v]) => [k, String(v)]);
+    return entries.length ? `?${new URLSearchParams(entries)}` : "";
+}
+function keyHeaders(key) { return key === undefined ? {} : { "Idempotency-Key": key }; }
+async function responseBody(response) {
+    try {
+        return await response.json();
+    }
+    catch (cause) {
+        const type = response.ok ? "invalid_response" : "http";
+        throw new VerdictError(response.status, type, response.ok ? "Verdict returned invalid JSON" : `HTTP ${response.status}`, { cause: cause instanceof Error ? cause.message : String(cause) });
+    }
+}
+function apiError(data) {
+    if (!data || typeof data !== "object" || !("error" in data))
+        return undefined;
+    const error = data.error;
+    if (!error || typeof error !== "object" || !("type" in error) || !("message" in error))
+        return undefined;
+    if (typeof error.type !== "string" || typeof error.message !== "string")
+        return undefined;
+    return { type: error.type, message: error.message, issues: "issues" in error ? error.issues : undefined, details: { ...error } };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@verdict-ai/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Verdict TypeScript SDK — a Resend-style client for the evaluation API.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@verdict-ai/core": "0.2.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ustay-coder/verdict.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://github.com/Ustay-coder/verdict#readme",
+  "bugs": {
+    "url": "https://github.com/Ustay-coder/verdict/issues"
+  },
+  "keywords": [
+    "evaluation",
+    "rubric",
+    "decision-model",
+    "jev",
+    "clef",
+    "scoring",
+    "llm-judge",
+    "mcp"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
 }