@verdict-ai/api 0.0.0-stage → 0.2.0

package/dist/openapi.d.ts

@@ -0,0 +1,463 @@
+/**
+ * Describes the public REST operations for API discovery.
+ * The published paths mirror route registration; runtime validation remains owned by request schemas.
+ */
+import type { RouteGroup } from "./app.js";
+/** The document for an app that serves only some route groups: paths of the others are left out. */
+export declare function openapiFor(groups: readonly RouteGroup[]): {
+    paths: {
+        [k: string]: {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+        } | {
+            get: {
+                summary: string;
+            };
+            put: {
+                summary: string;
+            };
+            delete: {
+                summary: string;
+            };
+        } | {
+            get: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        } | {
+            get: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+        } | {
+            get: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+        } | {
+            get: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+        } | {
+            get: {
+                summary: string;
+            };
+        } | {
+            delete: {
+                summary: string;
+            };
+        } | {
+            get: {
+                summary: string;
+                security: never[];
+            };
+        } | {
+            get: {
+                summary: string;
+                security: never[];
+            };
+        } | {
+            get: {
+                summary: string;
+                security: never[];
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+        } | {
+            delete: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        } | {
+            delete: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        } | {
+            get: {
+                summary: string;
+            };
+            delete: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+        } | {
+            get: {
+                summary: string;
+            };
+        } | {
+            get: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        } | {
+            get: {
+                summary: string;
+            };
+            delete: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        } | {
+            get: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        } | {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        } | {
+            delete: {
+                summary: string;
+            };
+        };
+    };
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description: string;
+    };
+    servers: {
+        url: string;
+    }[];
+    security: {
+        bearer: never[];
+    }[];
+    components: {
+        securitySchemes: {
+            bearer: {
+                type: string;
+                scheme: string;
+            };
+        };
+    };
+};
+export declare const openapi: {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description: string;
+    };
+    servers: {
+        url: string;
+    }[];
+    security: {
+        bearer: never[];
+    }[];
+    components: {
+        securitySchemes: {
+            bearer: {
+                type: string;
+                scheme: string;
+            };
+        };
+    };
+    paths: {
+        "/v1/rubrics": {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/rubrics/validate": {
+            post: {
+                summary: string;
+            };
+        };
+        "/v1/rubrics/{id}": {
+            get: {
+                summary: string;
+            };
+            put: {
+                summary: string;
+            };
+            delete: {
+                summary: string;
+            };
+        };
+        "/v1/rubrics/{id}/calibration": {
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/evaluations": {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/evaluations/{id}": {
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/evaluations/{id}/retry": {
+            post: {
+                summary: string;
+            };
+        };
+        "/v1/evaluations/{id}/scores": {
+            post: {
+                summary: string;
+            };
+        };
+        "/v1/evaluations/{id}/aggregate": {
+            post: {
+                summary: string;
+            };
+        };
+        "/v1/tasks": {
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/batches": {
+            post: {
+                summary: string;
+            };
+        };
+        "/v1/hub/config": {
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/hub/login": {
+            post: {
+                summary: string;
+            };
+        };
+        "/v1/hub/me": {
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/hub/keys/{id}": {
+            delete: {
+                summary: string;
+            };
+        };
+        "/v1/public/rubrics": {
+            get: {
+                summary: string;
+                security: never[];
+            };
+        };
+        "/v1/public/rubrics/{owner}/{slug}": {
+            get: {
+                summary: string;
+                security: never[];
+            };
+        };
+        "/v1/public/publications/{id}": {
+            get: {
+                summary: string;
+                security: never[];
+            };
+        };
+        "/v1/publications": {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/publications/preview": {
+            post: {
+                summary: string;
+            };
+        };
+        "/v1/publications/{id}": {
+            delete: {
+                summary: string;
+            };
+        };
+        "/v1/projects": {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/projects/{project}": {
+            delete: {
+                summary: string;
+            };
+        };
+        "/v1/projects/{project}/environments": {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/projects/{project}/environments/{environment}": {
+            get: {
+                summary: string;
+            };
+            delete: {
+                summary: string;
+            };
+        };
+        "/v1/projects/{project}/environments/{environment}/promotions": {
+            post: {
+                summary: string;
+            };
+        };
+        "/v1/projects/{project}/environments/{environment}/rollbacks": {
+            post: {
+                summary: string;
+            };
+        };
+        "/v1/projects/{project}/history": {
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/projects/{project}/rubrics": {
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/projects/{project}/rubrics/{name}/versions": {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/projects/{project}/rubrics/{name}/versions/{id}": {
+            get: {
+                summary: string;
+            };
+            delete: {
+                summary: string;
+            };
+        };
+        "/v1/projects/{project}/reports/runs": {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/projects/{project}/reports/runs/{runId}": {
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/projects/{project}/reports/comparisons": {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/admin/keys": {
+            post: {
+                summary: string;
+            };
+            get: {
+                summary: string;
+            };
+        };
+        "/v1/admin/keys/{id}": {
+            delete: {
+                summary: string;
+            };
+        };
+    };
+};

package/dist/openapi.js

@@ -0,0 +1,58 @@
+const GROUP_PATHS = {
+    evaluations: ["/v1/evaluations", "/v1/tasks", "/v1/batches"],
+    rubrics: ["/v1/rubrics"],
+    hub: ["/v1/hub", "/v1/public", "/v1/publications"],
+    control: ["/v1/projects"],
+};
+/** The document for an app that serves only some route groups: paths of the others are left out. */
+export function openapiFor(groups) {
+    const off = Object.keys(GROUP_PATHS).filter((g) => !groups.includes(g)).flatMap((g) => GROUP_PATHS[g]);
+    const served = (path) => !off.some((prefix) => path === prefix || path.startsWith(`${prefix}/`));
+    return { ...openapi, paths: Object.fromEntries(Object.entries(openapi.paths).filter(([path]) => served(path))) };
+}
+export const openapi = {
+    openapi: "3.1.0",
+    info: { title: "Verdict Evaluation API", version: "0.1.0", description: "Customizable rubrics, pluggable judges (LLM / human / benchmark), customizable aggregation." },
+    servers: [{ url: "/" }],
+    security: [{ bearer: [] }],
+    components: { securitySchemes: { bearer: { type: "http", scheme: "bearer" } } },
+    paths: {
+        "/v1/rubrics": { post: { summary: "Create rubric (JSON or YAML body)" }, get: { summary: "List rubrics" } },
+        "/v1/rubrics/validate": { post: { summary: "Validate a rubric without storing it" } },
+        "/v1/rubrics/{id}": { get: { summary: "Get rubric" }, put: { summary: "Replace rubric" }, delete: { summary: "Delete rubric" } },
+        "/v1/rubrics/{id}/calibration": { get: { summary: "Calibration report (`?target=0.8&buckets=5&limit=1000`)" } },
+        "/v1/evaluations": { post: { summary: "Evaluate a subject (sync; `async:true` for 202). Optional Idempotency-Key header (1–255 chars); replay 200, conflict 409, TTL 24h" }, get: { summary: "List evaluations" } },
+        "/v1/evaluations/{id}": { get: { summary: "Get evaluation (`?evidence=true` for full text)" } },
+        "/v1/evaluations/{id}/retry": { post: { summary: "Re-enqueue a failed evaluation (202; unknown 404; not failed 409)" } },
+        "/v1/evaluations/{id}/scores": { post: { summary: "Submit a human score for a pending criterion" } },
+        "/v1/evaluations/{id}/aggregate": { post: { summary: "Re-aggregate with a different aggregation config (no re-judging)" } },
+        "/v1/tasks": { get: { summary: "Pending human-rating tasks (`?rater=`)" } },
+        "/v1/batches": { post: { summary: "Evaluate many subjects against one rubric and rank them. Optional Idempotency-Key header (1–255 chars); replay 200, conflict 409, TTL 24h" } },
+        "/v1/hub/config": { get: { summary: "Public: the GitHub OAuth client id for sign-in (null when the server publishes under tenant ids), and `signIn` when the server runs CLI sign-in itself (browser approval)" } },
+        "/v1/hub/login": { post: { summary: "Public: trade a GitHub token from the device flow for a hub API key bound to that account (201 { apiKey, keyId, handle, tenantId })" } },
+        "/v1/hub/me": { get: { summary: "Who this key publishes as" } },
+        "/v1/hub/keys/{id}": { delete: { summary: "Revoke one of this account's hub keys (sign out)" } },
+        "/v1/public/rubrics": { get: { summary: "Public, no key: search published cards (q, domain, locale, type, owner, limit ≤ 50); one result per owner/slug at its newest live version", security: [] } },
+        "/v1/public/rubrics/{owner}/{slug}": { get: { summary: "Public, no key: a card at ?version= (default: newest live) with its version history; 410 when that version was withdrawn", security: [] } },
+        "/v1/public/publications/{id}": { get: { summary: "Public, no key: one publication by id; 410 when withdrawn", security: [] } },
+        "/v1/publications": { post: { summary: "Publish a rubric version, chosen public cases and run summaries to the hub (one criterion, licence, binary threshold; 400 with issues)" }, get: { summary: "List this tenant's publications, withdrawn included" } },
+        "/v1/publications/preview": { post: { summary: "Build the publication without storing it: { ok, issues, warnings, publication } — the exact document publish would store" } },
+        "/v1/publications/{id}": { delete: { summary: "Withdraw a publication (it stays readable by id, marked withdrawn, and leaves search)" } },
+        "/v1/projects": { post: { summary: "Create a project: { name } (201; 409 already_exists)" }, get: { summary: "List this tenant's projects" } },
+        "/v1/projects/{project}": { delete: { summary: "Delete a project and everything in it. Body { confirm: \"<name>\" }" } },
+        "/v1/projects/{project}/environments": { post: { summary: "Create an environment: { name } (201; 409 already_exists)" }, get: { summary: "List a project's environments" } },
+        "/v1/projects/{project}/environments/{environment}": { get: { summary: "An environment and its pointers: which version of each rubric it runs. `?include=rubrics` adds each rubric document (what services poll); answers carry an ETag, and If-None-Match gets 304 while nothing changed" }, delete: { summary: "Delete an environment and its pointers; its history stays. Body { confirm: \"<name>\" }" } },
+        "/v1/projects/{project}/environments/{environment}/promotions": { post: { summary: "Move pointers, all or none: { changes: [{ name, versionId | null, expected | null }], note? } (≤ 20 changes; null versionId removes the pointer; 409 pointer_conflict with the current versions when `expected` is stale)" } },
+        "/v1/projects/{project}/environments/{environment}/rollbacks": { post: { summary: "Undo a pointer's latest change: { name, expected, note? } (409 pointer_conflict / nothing_to_roll_back)" } },
+        "/v1/projects/{project}/history": { get: { summary: "Pointer changes, newest first (`?environment=&name=&limit=`)" } },
+        "/v1/projects/{project}/rubrics": { get: { summary: "Rubric names of a project, with version counts" } },
+        "/v1/projects/{project}/rubrics/{name}/versions": { post: { summary: "Upload an immutable rubric version: { id, rubric, parentVersionId?, fork? }. The server freezes the rubric again and refuses another id (201 new, 200 already there, 413 over 1 MB)" }, get: { summary: "List a rubric's versions, newest first, without the rubric documents" } },
+        "/v1/projects/{project}/rubrics/{name}/versions/{id}": { get: { summary: "One version with its rubric document" }, delete: { summary: "Delete a version no environment points at (409 in_use otherwise)" } },
+        "/v1/projects/{project}/reports/runs": { post: { summary: "Report a run's numbers: { name, run, report, datasetName?, source?, version? }. No case ids, inputs or outputs are read. `version` uploads the run's rubric version when the server lacks it (201 new, 200 already reported, 400 unknown_version)" }, get: { summary: "Run reports, newest run first (`?name=&versionId=&dataset=&limit=`)" } },
+        "/v1/projects/{project}/reports/runs/{runId}": { get: { summary: "One run report" } },
+        "/v1/projects/{project}/reports/comparisons": { post: { summary: "Report a comparison of two reported runs: { name, comparison, source? } — counts per criterion, no per-case rows (400 unknown_run)" }, get: { summary: "Comparison reports, newest first (`?name=&head=&limit=`)" } },
+        "/v1/admin/keys": { post: { summary: "Create an API key for a tenant (admin)" }, get: { summary: "List a tenant's keys (admin, `?tenant=`)" } },
+        "/v1/admin/keys/{id}": { delete: { summary: "Revoke a key (admin)" } },
+    },
+};
+//# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

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

package/dist/present.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Projects stored evaluations into public REST representations.
+ * Evidence text and rating details are included only when requested; frozen rubric policy remains visible.
+ */
+import type { Evaluation } from "@verdict-ai/core";
+/** Public view of an evaluation: strip bulky evidence text unless asked. */
+export declare function present(ev: Evaluation, { evidence, ratings }?: {
+    evidence?: boolean | undefined;
+    ratings?: boolean | undefined;
+}): {
+    rubric: {
+        id: string | undefined;
+        name: string;
+        version: string;
+        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;
+        };
+    };
+    evidence: import("@verdict-ai/core").Evidence[] | {
+        chars: number;
+        inputIndex: number;
+        kind: import("@verdict-ai/core").Input["type"];
+        label: string;
+        tags: string[];
+        json?: unknown;
+        source?: string;
+        truncated?: boolean;
+        images?: import("@verdict-ai/core").ImageMeta[];
+        stats: {
+            chars: number;
+            words: number;
+            lines: number;
+        };
+        warnings?: string[];
+    }[];
+    criteria: {
+        criterionId: string;
+        name: string;
+        weight: number;
+        group?: string;
+        status: "scored" | "pending" | "error" | "excluded";
+        choice?: string;
+        score?: number;
+        normalized?: number;
+        choices?: Record<string, number>;
+        pending: number;
+        gate?: {
+            passed: boolean;
+            message?: string;
+        };
+    }[];
+    job?: {
+        attempts: number;
+        maxAttempts: number;
+        lastError?: string;
+        nextAttemptAt?: string;
+        deadLettered?: boolean;
+    };
+    id: string;
+    tenantId?: string;
+    idempotencyKey?: string;
+    rubricId?: string;
+    subject: import("@verdict-ai/core").Subject;
+    status: import("@verdict-ai/core").EvaluationStatus;
+    aggregate: import("@verdict-ai/core").AggregateResult;
+    pendingTasks: Array<{
+        criterionId: string;
+        raterId?: string;
+        allowedRaters?: string[];
+        instructions?: string;
+    }>;
+    checks?: Array<{
+        id: string;
+        probability: number | null;
+        passed: boolean;
+        action: "abort" | "fail" | "flag";
+        message?: string;
+        error?: string;
+    }>;
+    error?: string;
+    inputErrors?: import("@verdict-ai/core").InputError[];
+    usage: {
+        decisionCalls: number;
+        llmCalls: number;
+        inputTokens: number;
+        outputTokens: number;
+        durationMs: number;
+    };
+    metadata?: Record<string, unknown>;
+    webhook?: string;
+    batchId?: string;
+    createdAt: string;
+    updatedAt: string;
+};

package/dist/present.js

@@ -0,0 +1,10 @@
+/** Public view of an evaluation: strip bulky evidence text unless asked. */
+export function present(ev, { evidence = false, ratings = true } = {}) {
+    return {
+        ...ev,
+        rubric: { id: ev.rubric.id, name: ev.rubric.name, version: ev.rubric.version, aggregation: ev.rubric.aggregation },
+        evidence: evidence ? ev.evidence : ev.evidence.map(({ text, ...rest }) => ({ ...rest, chars: text.length })),
+        criteria: ratings ? ev.criteria : ev.criteria.map(({ ratings: _r, ...c }) => c),
+    };
+}
+//# sourceMappingURL=present.js.map

package/dist/present.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"present.js","sourceRoot":"","sources":["../src/present.ts"],"names":[],"mappings":"AAKA,4EAA4E;AAC5E,MAAM,UAAU,OAAO,CAAC,EAAc,EAAE,EAAE,QAAQ,GAAG,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,EAAE;IAC/E,OAAO;QACL,GAAG,EAAE;QACL,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE;QAClH,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5G,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;KAChF,CAAC;AACJ,CAAC"}

package/dist/queue-cloudflare.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Adapts serializable engine jobs to a Cloudflare queue binding.
+ * Messages carry request data only; the consumer owns execution and retry policy.
+ */
+import type { Job, Queue } from "@verdict-ai/core";
+/** Sends jobs to the queue binding; enqueue rejects when the binding cannot accept a message. */
+export declare class CloudflareQueue implements Queue {
+    private binding;
+    constructor(binding: {
+        send(body: Job, options?: {
+            delaySeconds?: number;
+        }): Promise<unknown>;
+    });
+    enqueue(job: Job, opts?: {
+        delayMs?: number;
+    }): Promise<void>;
+}

package/dist/queue-cloudflare.js

@@ -0,0 +1,11 @@
+/** Sends jobs to the queue binding; enqueue rejects when the binding cannot accept a message. */
+export class CloudflareQueue {
+    binding;
+    constructor(binding) {
+        this.binding = binding;
+    }
+    async enqueue(job, opts) {
+        await this.binding.send(job, { delaySeconds: Math.ceil((opts?.delayMs ?? 0) / 1000) });
+    }
+}
+//# sourceMappingURL=queue-cloudflare.js.map

package/dist/queue-cloudflare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-cloudflare.js","sourceRoot":"","sources":["../src/queue-cloudflare.ts"],"names":[],"mappings":"AAMA,iGAAiG;AACjG,MAAM,OAAO,eAAe;IACN;IAApB,YAAoB,OAAmF;QAAnF,YAAO,GAAP,OAAO,CAA4E;IAAG,CAAC;IAC3G,KAAK,CAAC,OAAO,CAAC,GAAQ,EAAE,IAA2B;QACjD,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;CACF"}